记一下这次上线踩过的点,免得下次重新搜。

构建设置

项值
Build commandhugo --gc --minify
Build output directorypublic
Root directory留空
Production branchmain

环境变量里必须加 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 一样快。