博客网站的建立

这篇文章记录我从零搭起个人博客的完整过程,工具、坑点和我做出的选择。

为什么选 Hexo + Fluid

我想要一个写作体验简单、生成快、能自由掌控的方案。Hexo 只要 Node 环境就能跑,Fluid 主题颜值和可定制性都不错,于是确定组合:Hexo + Fluid。

第一步:把环境备好

我先装 Node.js 18,然后装 Hexo CLI。

1
npm i -g hexo-cli

第二步:把仓库“生”出来

在目标目录初始化并装依赖:

1
2
3
hexo init my-blog
cd my-blog
npm i

本地跑起来确认:

1
npm run server

第三步:主题换成 Fluid

安装主题:

1
npm i hexo-theme-fluid

在 ./_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
hexo new post "我的第一篇博客"

配图就放到同名资源文件夹里引用。然后创建关于页:

1
hexo new page about

我把 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
2
3
4
5
6
7
8
9
10
post:
comments:
enable: true
type: waline

waline:
serverURL: https://评论域名
lang: 'zh-CN'
emoji: ['https://cdn.jsdelivr.net/gh/walinejs/emojis/weibo']
login: 'force'

第八步:PV/UV 统计

LeanCloud 在中国区,server_url 用 https://api.lc-cn-n1-shared.com。我在主题里打开页脚统计与文章浏览量,都走 LeanCloud。

第九步:部署与自定义域名

部署我选 GitHub Pages,配置如下:

1
2
3
4
deploy:
type: git
repo: git@github.com:用户名/仓库.git
branch: main

执行:

1
2
3
npm run clean
npm run build
npm run deploy

自定义域名把 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 验证是否成功
    DNSCHECKER 验证

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


博客网站的建立
https://shaoyanzhe.site/2025/12/11/博客网站的建立/
作者
邵岩哲
发布于
2025年12月11日
许可协议