Cloudflare Pages 上线备忘录
目录
记一下这次上线踩过的点,免得下次重新搜。
构建设置
| 项 | 值 |
|---|---|
| Build command | hugo --gc --minify |
| Build output directory | public |
| Root directory | 留空 |
| Production branch | main |
环境变量里必须加 HUGO_VERSION,值和本地 hugo version 查到的一致。开了 PR 预览的话,Preview 环境也要加同一个变量,否则预览部署会构建失败。
绑定域名的顺序
先在 Pages 后台 Custom domains 关联域名,再去配 DNS。 反过来直接 CNAME 指向 xxx.pages.dev 会报 522,证书也可能签不下来。
- 根域名:必须把域名加为 Cloudflare zone 并改 NS,之后它自动创建 CNAME
- 子域名:在原域名商加一条 CNAME 即可
- 域名原先有 CAA 记录的,要放行
letsencrypt.org、pki.goog、digicert.com、comodoca.com
其他
static/_headers 可以配响应头,enableRobotsTXT = true 会自动生成 robots.txt 并带上 sitemap 地址。图标走目标站 /favicon.ico,加载失败会回退成名称首字,所以别人换图标顶多裂一张,不影响整站。
国内访问没有大陆节点,这是免费版的硬边界,绑自定义域名能改善一部分,但别指望和国内 CDN 一样快。