CloudflarePages+GitHub零成本博客搭建手册
🚀 零成本搭建永不过期的个人博客 (CF Pages + GitHub)
这个方案的核心逻辑是:GitHub 存放源代码 + Cloudflare Pages 负责自动构建、托管和全球加速。
第一步:选择并初始化博客框架
推荐使用 Hugo (速度最快) 或 Hexo (插件最丰富)。以下以 Hugo 为例:
- 在 GitHub 上找模板:
- 访问 Hugo Themes 或直接在 GitHub 搜索
Hugo theme。 - 快捷操作:找一个带 "Deploy to Cloudflare" 按钮的项目,可以直接一键克隆。
- 访问 Hugo Themes 或直接在 GitHub 搜索
- 创建你的仓库:
- 在 GitHub 新建一个仓库(例如:
my-blog)。 - 如果你本地有代码,关联并
git push到 GitHub。
- 在 GitHub 新建一个仓库(例如:
第二步:配置 Cloudflare Pages
- 登录控制台:打开 Cloudflare Dashboard,点击左侧菜单的 Workers & Pages。
- 创建项目:点击 Create application -> Pages -> Connect to Git。
- 授权 GitHub:选择你刚才创建的
my-blog仓库。 - 构建设置 (Build Settings):
- Framework preset: 选择
Hugo(或你用的框架)。 - Build command:
hugo。 - Build output directory:
public。
- Framework preset: 选择
- 部署:点击 Save and Deploy。
第三步:获取你的免费域名
- 部署完成后,Cloudflare 会分配一个类似
my-blog.pages.dev的二级域名。 - 特性:
- 自带 SSL 证书(HTTPS)。
- 全球 CDN 加速。
- 永久免费且不会过期。
第四步:进阶玩法(选配)
1. 绑定顶级域名
如果你以后买了 .com 或 .top 域名,直接在 Pages 的 Custom domains 选项卡里添加即可。CF 会自动帮你配置 DNS 和证书。
2. 内容发布流程
- 你不需要在 Cloudflare 网页上操作。
- 流程:本地写 Markdown 文章 ->
git commit->git push。 - 自动触发:Cloudflare 监测到 GitHub 提交后,会在 1 分钟内自动完成构建并更新上线。
3. 评论系统 (完全免费)
推荐使用 Waline (基于 LeanCloud) 或 Giscus (基于 GitHub Discussions)。
为什么这个方案“永不丢失”?
- 代码在 GitHub:即使 Cloudflare 倒闭(概率极低),你的原始文章和模版都在 Git 仓库里,随时可以迁移。
- 静态化:博客生成的全是 HTML 文件,不依赖数据库,极难被黑,维护成本几乎为零。
- 免费额度:Cloudflare Pages 的免费额度对于个人博客来说绰绰有余(无限流量,每月 500 次构建)。
💡 避坑小建议
- 图片处理:不要把大量高清原图直接塞进 GitHub 仓库。建议使用 Cloudflare R2(有免费额度)或者简单的图床。
- 环境版本:如果在构建时报错,记得在 Pages 的环境变量里设置
HUGO_VERSION。