把 Hexo 博客搬上 Cloudflare Pages:关机也不掉线,改 GitHub 即发布
起因很朴素:博客一直跑在家里一台 Windows 的 Hyper-V Ubuntu 虚拟机里,靠 Cloudflare Tunnel 暴露公网。电脑一关、VM 一停,博客就 502。我想把它变成”读永远在线、写和评论都不依赖家里电脑”。这篇记录整个迁移到 Cloudflare Pages + GitHub 自动构建 + Giscus 评论的过程,以及踩到的坑。
目标
- 读:任何人任何时间都能打开,家里电脑关机也在线。
- 写:改文章不需要开家里那台机器,在 GitHub 上改
.md提交即发布。 - 评论:访客能留言、我能管理,且不用自己养一个后端。
最终架构
1 | GitHub 仓库(xiaodaoblog, Hexo 源码) |
关键点:Cloudflare Tunnel 是出站的,所以”服务在哪跑”和”域名能不能通”解耦了——静态内容一旦交给 Pages CDN,就跟家里机器彻底无关。
第一步:静态产物上 Pages
Hexo generate 出来的 public/ 是纯静态。用 wrangler 直接部署:
1 | npm i -g wrangler |
拿到 blog-xxx.pages.dev 后,在 Pages 项目里绑定自定义域 blog.dingdao.me。因为域名本来就在 Cloudflare,改一条 CNAME 即可:把原来指向 <tunnel-id>.cfargotunnel.com 的记录改成 <project>.pages.dev(保持橙云 proxied)。
第二步:评论换成 Giscus
原来是自己写的评论接口(Flask + SQLite),家里 VM 一关评论就废。换成 Giscus——评论数据存在 GitHub Discussions,零后端、免费、永久在线。
三步:
- 仓库开 Discussions,装 giscus GitHub App(授权到该仓库)。
- 在 giscus.app 选好映射方式(我用
pathname,每篇文章 URL 对应一个 discussion)、语言zh-CN,拿到data-repo-id/data-category-id。 - 把嵌入片段塞进主题的文章页(用
is_post()只在文章页渲染),同时把旧的自建评论接口关掉。
第三步:源码进 GitHub + 自动构建
把 Hexo 源码(排除 node_modules / public / db.json)推到一个 GitHub 仓库,然后让 Pages 连这个仓库自动构建。
这里踩了最大的一个坑:在 Cloudflare 后台连上 GitHub 后,默认 Build command 是空的,Pages 不会执行 hexo generate,直接把源码仓库当产物部署 → 根路径 404。必须显式设置:
1 | Build command: npx hexo generate |
配好后,在 GitHub 上改 .md → 提交 → Pages 自动重新构建发布,全程不用碰家里电脑。
推送用 Deploy Key(仓库级 SSH 公钥,比账号级 token 安全)比账号级令牌干净;GitHub 对”加部署密钥/装第三方 App”会弹 sudo 二次验证(2FA),这一下得本人输验证码。
第四步:访客统计
用 Cloudflare Web Analytics:免费、无 Cookie、不跟踪跨站,Pages 项目里一键开启会自动注入 beacon。能看到来源(referrer)、各页面、平均停留时间、国家/设备/浏览器。想要更细的”访问路径/会话流转”,可以换自托管的 Umami。
踩坑清单(速查)
| 坑 | 现象 | 解法 |
|---|---|---|
| Pages 连 Git 后不构建 | 站点 404 / 部署的是源码 | 设 npx hexo generate + 输出 public |
| 自定义域不生效 | 一直指向旧隧道 | 把 CNAME 从 *.cfargotunnel.com 改到 *.pages.dev |
| 评论迁 Giscus 后旧接口还在 | 页面出现两套评论 | 关掉主题里自建评论的 comment_api 配置 |
| 中文标题 slug | URL 里是编码后的中文 | 正常,permalink 用 :title 即可 |
| 点赞/喜欢依赖后端 | 关机后失效 | 用 _worker.js 代理 /api 回后端,或改用 Giscus 的 reactions |
结果
- 博客 + 门户现在跑在 Pages CDN,家里电脑关机照样在线;
- 写文章 = 在 GitHub 改
.md提交,几十秒后自动上线; - 评论 = GitHub Discussions,我能直接在 GitHub 后台管理垃圾评论;
- 统计 = Cloudflare Web Analytics。
家里那台机器从此只需要在”跑动态服务(面板/网关/智能家居)”时才开机,博客这条线彻底解耦了。