这个博客是纯静态的:四个文件,一个 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 不是错误。