博客网站的建立
这篇文章记录我从零搭起个人博客的完整过程,工具、坑点和我做出的选择。
为什么选 Hexo + Fluid
我想要一个写作体验简单、生成快、能自由掌控的方案。Hexo 只要 Node 环境就能跑,Fluid 主题颜值和可定制性都不错,于是确定组合:Hexo + Fluid。
第一步:把环境备好
我先装 Node.js 18,然后装 Hexo CLI。
1 | |
第二步:把仓库“生”出来
在目标目录初始化并装依赖:
1 | |
本地跑起来确认:
1 | |
第三步:主题换成 Fluid
安装主题:
1 | |
在 ./_config.yml 把 theme 改成 fluid。我另外新建了 ./_config.fluid.yml 专门放个性化配置,后续更新主题不会丢自定义。
第四步:把站点配置对齐
在 ./_config.yml 里我设了:
language: zh-CN、timezone: Asia/Shanghai- 永久链接:
permalink: :year/:month/:day/:title/ post_asset_folder: true(文章有自己的资源文件夹)
第五步:先美化再写
在 ./_config.fluid.yml 我做了这几件事:
- 导航标题改成
Blog - 开启本地搜索、暗色模式、目录 TOC、字数统计
- 首页和关于页加了自己的 Banner 与头像
第六步:写第一篇文章与关于页
新文章:
1 | |
配图就放到同名资源文件夹里引用。然后创建关于页:
1 | |
我把 source/about/index.md 的布局设为 about,并写了个人介绍、技能栈、链接。
第七步:评论系统的选择与踩坑
我先用 Waline,原因是有社交登录且可自托管。服务端我放在了 Vercel,环境变量这样配:
- 基本:
LEAN_ID、LEAN_KEY、LEAN_SERVER=https://api.lc-cn-n1-shared.com - 数据库:
MONGO_DB、MONGO_USER、MONGO_PASSWORD、MONGO_HOST、MONGO_PORT=27017、MONGO_OPT_SSL=true - 安全:
SECURE_DOMAINS必须是纯域名逗号分隔(比如shaoyanzhe.site,waline域名,localhost:4000) SERVER_URL写服务端的完整 https 地址
客户端在 ./_config.fluid.yml:
1 | |
第八步:PV/UV 统计
LeanCloud 在中国区,server_url 用 https://api.lc-cn-n1-shared.com。我在主题里打开页脚统计与文章浏览量,都走 LeanCloud。
第九步:部署与自定义域名
部署我选 GitHub Pages,配置如下:
1 | |
执行:
1 | |
自定义域名把 source/CNAME 写成 shaoyanzhe.site,DNS 指向 GitHub Pages。
第十步:为加载做加速
评论客户端脚本与样式我加了多源回退和懒加载;表情尽量用站内或国内 CDN;如仍受限,就把评论服务端迁到国内云并开 CDN,这一步对体验最明显。
总结
这就是我从零到上线的流程:选 Hexo + Fluid,先把写作体验和主题打磨好,再把评论与统计接起来,最后部署与加速。之后就专注内容本身了。
后来:我怎么解决 Waline 在国内不可访问的问题
实际跑上线后,评论区在国内网络加载不出来。我在网上找了很多资料:
主要参考:https://gem-jay.github.io/posts/3352780266/
1)给 Waline 换成自己的子域名
- 在域名控制台创建子域名:
comment.shaoyanzhe.site - DNS 记录设置为 CNAME,目标改为 Vercel 提示的专用地址,并保持“仅 DNS”不走代理
- 在 Vercel 的 Waline 项目里绑定
comment.shaoyanzhe.site,设为主域并开启“Redirect to primary domain”
这样就避开了 *.vercel.app 在国内的访问受限,评论接口都走自己的域名。
2)切换权威 DNS 到 Cloudflare(或在原权威 DNS 添加记录)
- 先把域名的 Nameservers 改成 Cloudflare 分配的两条,
- 等 NS 生效后,CNAME 才会以 Cloudflare 为权威对外解析;也可以选择继续用 DNSPod,并在 DNSPod 那边新增
comment的 CNAME(两种方案选其一) - 用 https://dnschecker.org/#CNAME/comment.shaoyanzhe.site DNSCHECKER 验证是否成功

这套调整保留了 Vercel 的托管,同时通过自定义子域名与权威 DNS 切换把访问路径稳定在国内网络里;客户端的多源回退与本地资源,让评论区的加载速度和可用性都更稳。