这个博客是纯静态的:四个文件,一个 CSS,一个 JS,没有构建步骤。所以选托管的时候,我要的不是「功能多」,是「别管我」。

用了一个月 Cloudflare Pages,记录一下完整流程和踩到的东西。

一、部署只要一条命令

不用连 Git,直接把目录推上去:

npx wrangler pages deploy . --project-name=fengzhi --branch=main

第一次会要求登录(浏览器授权),之后 token 存在本地。上传 6 个文件,1.2 秒,返回一个 xxx.fengzhi.pages.dev 的预览地址。整个过程不到十秒。

连 Git 也可以,push 自动构建。但对这种规模的项目,多一层构建反而多一处会坏的地方。

二、绑自定义域名,DNS 是唯一的手工活

Pages 项目里加域名是 API 一句话的事:

curl -X POST "https://api.cloudflare.com/client/v4/accounts/$ACC/pages/projects/fengzhi/domains" \
  -H "Authorization: Bearer $TOKEN" \
  --data '{"name":"blog.example.com"}'

但域名加进去不等于能用。它需要一条 CNAME:blog.example.com → fengzhi.pages.dev,并且必须开着橙云代理。

这里撞上了第一个坑。

坑一:wrangler 的 token 没有 DNS 权限

我以为 wrangler 登录过就能改一切。实际上它的 OAuth 令牌只有 pages:write、zone:read 这类 scope,没有 dns_records:edit。用同一个 token 去建记录,返回:

{"success":false,"errors":[{"code":10000,"message":"Authentication error"}]}

这不是配置问题,是权限边界。三条路:在 Dashboard 手点一条、用一个带 Zone.DNS Edit 的独立 API Token、或者开通 Terraform。我选了第一条,30 秒的事。

坑二:记录加完,先给你一个 522

CNAME 生效后立刻访问,返回 522(连接超时)。看着像配错了,其实不是。

Cloudflare 边缘已经知道这个域名归它管(所以 TLS 握手是成功的,证书也正常),但它还不知道这个域名背后的 Pages 项目已经准备好接流量。Pages 侧的域名状态这时还是 pending,校验项写着 CNAME record not set——它读的是内部状态,不是 DNS 缓存。

等了一分半,状态翻成 active,522 自己消失了。结论:绑完域名先等两分钟再判断,别急着改配置。

坑三:.html 后缀会被 308 吃掉

站点上线后我发现 /post.html 返回 308,跳到 /post。

这是 Pages 默认的 html_handling 行为:自动去掉 .html、补齐目录式 URL。本身不算错,但意味着两件事:

1. 站内链接最好统一写 /post,别写 /post.html,否则每次点击都多一次跳转;2. canonical 和 sitemap 里的地址必须跟着改,不然搜索引擎抓到的是一串跳转。

如果你确实想保留 .html,可以在 wrangler.toml 里写 html_handling = "none"。我选择顺着它的规则走——干净的 URL 本来也更好看。

三、顺手加的三个文件

纯静态站容易被忽略的是这三样,加起来不到二十行:

robots.txt     告诉爬虫可以抓,并指向 sitemap
sitemap.xml    列出所有页面和更新日期
_headers       Pages 专属,用来加安全头和缓存策略

_headers 长这样:

/*
  X-Content-Type-Options: nosniff
  X-Frame-Options: SAMEORIGIN
  Referrer-Policy: strict-origin-when-cross-origin

/assets/*
  Cache-Control: public, max-age=600, must-revalidate

注意静态资源的缓存别设太长。文件名没有 hash,设成一年的话,你改完样式,老访客一年都看不到。

四、一个月后的数据

  • 部署 11 次,每次 1–3 秒;
  • 免费额度:每月 500 次构建、无限静态请求、无限带宽;
  • 国内访问:时快时慢,取决于线路。这一点要有心理准备,Pages 没有国内节点。

五、值不值

如果你要的是「写完一篇,扔上去,三秒后线上就有了」,它比任何带后台的方案都省事。代价是所有动态能力都得自己接——评论、搜索、统计,一个都没有。

对我来说这个代价是正收益。少一个后台,就少一个会坏的东西。


补一句:这个站现在跑在 fengzhi.ttt.mobi 上,整个过程从零到能访问,大概二十分钟。其中十九分钟在等我搞明白 522 不是错误。