跟着云五老师的脚步 把博客换成 Cloudflare Pages ,免费支持私有仓库!后面发现搜索页面出现了小问题:可以搜索到关键字,但无法打开对应文章,似乎还是指向GitHubPages。最后让 AI 给我解决了,修改了 hugo 设置里的 baseline 以及把搜索使用的路径改为相对路径。
登录 Cloudflare Pages
首先确保 Hugo 博客已经在本地正常运行,并且推送到 GitHub 的私有仓库(如果已经有就修改设置即可)。
登录 Cloudflare Dashboard 。选择右上角的Add → Pages → Import an existing Git repository ,选择对应的仓库。
Note
| 配置项 | 值 |
|---|---|
| Production branch | main |
| Framework preset | Hugo |
| Build command | hugo |
| Build output directory | public |
设置环境变量
HUGO_VERSION = 0.137.0),否则可能默认旧版本。
Save and Deploy
Cloudflare 会自动拉取代码、构建并部署。完成后你会获得一个 xxx.pages.dev 的域名。
迁移完成后,可以把原仓库里的工作流禁用掉。
配置自定义域名 (可选)
如果有自己的域名:
- 在 Cloudflare Pages 项目 → Custom domains → Set up a custom domain
- 输入你的域名,Cloudflare 会自动添加 DNS 记录
- 自动颁发 SSL 证书(通常几分钟内完成)