Hexo 博客部署指南：从 GitHub Pages 到 Cloudflare Pages

记录一下本站的部署方案演进：从最初的 GitHub Pages 到现在的 Cloudflare Pages，解决国内访问慢的问题。

为什么要换部署方案？

GitHub Pages 虽然免费好用，但有一个致命问题：国内访问太慢了。经常打开一个页面要等好几秒，体验很差。

尝试过的方案：

• Gitee Pages：免费版已关闭
• Vercel：vercel.app 域名在国内部分地区被墙
• Cloudflare Pages：免费、国内能访问、自动部署 ✅

部署架构

本地写文章 → git push → GitHub 仓库（源码）→ Cloudflare Pages 自动构建 → 全球 CDN

同时保留 GitHub Pages 作为备用：

本地 hexo deploy → GitHub Pages（编译产物）

Cloudflare Pages 部署步骤

1. 准备源码仓库

把 Hexo 博客源码推到 GitHub：

cd blog
git init
git add .
git commit -m "blog source"
git remote add origin https://github.com/你的用户名/blog-source.git
git push -u origin main

.gitignore 需要排除这些：

node_modules/
public/
.deploy*/
db.json

2. 创建 Cloudflare Pages 项目

1. 登录 Cloudflare Dashboard
2. 左侧 Workers & Pages → Create → Pages → Import an existing Git repository
3. 授权 GitHub，选择源码仓库
4. 构建设置：
   • Build command: npx hexo generate
   • Build output directory: public
   • 环境变量: NODE_VERSION = 20
5. 点击 Deploy

3. 等待构建完成

大约 30 秒就能构建完成，Cloudflare 会分配一个 xxx.pages.dev 的域名。

日常发文流程

以前需要 hexo clean + generate + deploy 三连，现在只需要：

# 写文章
npx hexo new "文章标题"

# 推送源码，自动部署
git add .
git commit -m "新文章"
git push

推完代码 Cloudflare 自动构建，1 分钟内上线。

对比总结

方案	国内速度	自动部署	免费	需要域名
GitHub Pages	慢	需手动 hexo deploy	✅	❌
Cloudflare Pages	较快	✅ git push 即部署	✅	❌

小贴士

• 两个平台可以同时用，互为备份
• Cloudflare Pages 每月 500 次构建，个人博客完全够用
• 如果有自定义域名，可以在 Cloudflare 绑定，速度更快
• 构建失败大概率是 Node 版本问题，确保 NODE_VERSION >= 20

---

希望这篇文章能帮到同样被 GitHub Pages 速度困扰的同学。