一、整条链路长什么样#

几个值得注意的点：

• Cloudflare 主动拉代码，不是 GitHub 推产物。所以你的密钥不需要交给 GitHub Actions，Cloudflare 用的是它自己跟 GitHub 的 OAuth 授权。
• 部署是原子的：新构建完整成功后才切换，失败不影响线上版本。这一点比很多自建方案强 —— 你 push 了一个坏 commit，线上还是好的。
• 每次 push 都有独立的部署 URL，除了 production 还有一堆 preview 部署，24 小时后自动清理。想看草稿效果随便推。

二、免费额度到底有多少#

Cloudflare Pages 免费版（Free plan）的关键数字：

TIP

“不限流量”这一条要重点说一下。很多静态托管（Vercel Hobby、Netlify 免费版）都有流量/构建额度限制，超了就限速或停服。Cloudflare Pages 免费版不按流量收费 —— 这也是我最后选它的主要原因之一。

关键约束：注册时不要绑信用卡。 绑卡后会进入需要验证的账户体系，一堆原本免费的功能会变成”需要开通付费”。这个博客从头到尾只在免费额度里跑。

三、为什么不用备案#

这个是很多国内用户的顾虑，讲清楚原理就不神秘了。

ICP 备案的触发条件是两个同时成立：

1
① 网站内容/服务器 面向中国大陆境内用户提供服务
2
② 服务器 部署在中国大陆境内（境内 IP 的机房）
3

4
备案才需要。

而 Pages 的机器在 Cloudflare 的全球 anycast 网络上（境外节点）。你的域名解析过去，落到的是境外机房的 IP，不满足第 ② 条，所以不需要备案。

WARNING

需要避开的坑：

• 不要开 Cloudflare 中国网络（China Network） —— 那个是企业版付费功能，明确要求域名已完成 ICP 备案。开了反而会要求你有备案。
• 如果你买的是 .cn 域名并做实名认证，注意 .cn 域名本身在境内就有实名要求，这跟站点备案是两件事。

我的站点现在跑在 ycxdev.com 上，走的就是海外 anycast。国内访问速度取决于运营商和跨境链路，但这不是”不合规”的问题，只是延迟问题。

四、顺手白嫖的 Cloudflare 设施#

Pages 只是入口。同一个账号下免费额度里还有一堆能直接用的东西，我都用上了：

具体我这个博客用到的：

1
// functions/api/views.ts （简化）
2
export async function onRequestGet({ request, env }) {
3
  const path = new URL(request.url).searchParams.get("path");
4
  const key = `v:${path}`;
5
  const n = parseInt((await env.VIEW_COUNTS.get(key)) ?? "0") + 1;
6
  await env.VIEW_COUNTS.put(key, String(n));
7
  return Response.json({ views: n });
8
}

1
<!-- Cloudflare 自动注入的 beacon -->
2
<script defer src="https://static.cloudflareinsights.com/beacon.min.js"
3
        data-cf-beacon='{"token":"<你的 32 位 token>"}'></script>

五、Cloudflare Pages 部署 Astro 的几个坑#

Astro 是 Cloudflare 官方推荐的框架之一（他们有专门的 Pages 集成文档），但纯静态输出用 Pages 时不需要 adapter。我踩过的坑：

1
20

1
# 仓库根目录加一个 corepack 声明
2
"packageManager": "[email protected]"

1
public/_headers  →  dist/_headers  →  边缘节点生效

1
/*
2
  X-Content-Type-Options: nosniff
3
  Referrer-Policy: strict-origin-when-cross-origin

六、为什么源码一定放 GitHub#

这一点我一开始想错过，后来发现是整个方案的地基。

1
Cloudflare Pages  ┐
2
                  ├──→ 内容以 GitHub 仓库为唯一来源（single source of truth）
3
Sveltia CMS       ┘

• Pages 只是构建产物。删了重建一条命令，不丢任何东西。
• CMS 也只是编辑器，它提交的变更最终是往仓库里 push Markdown 文件。所以 CMS 挂了不影响发布。
• 有完整历史。哪天想回退到三个月前的某个版本，git revert 一下，Cloudflare 自动重新构建。
• 迁移成本低。以后想换别的静态托管（Vercel / Netlify / 自建），换的是部署配置，内容文件一个字都不用改。

NOTE

我的仓库是 Private。内容里有私人记录，而且 Cloudflare 的 GitHub 集成支持私有仓库 —— 构建机上拿的是只读的短期凭据，源码不会因为部署而泄露。

小结#

• 架构就一句话：GitHub 是唯一真源，Cloudflare Pages 负责构建和 CDN，中间一个 webhook 打通。
• 成本 ¥0：不绑卡、不用服务器、不备案（域名可选，先白嫖 *.pages.dev 也行）。
• 不限流量是 Pages 免费版最大的卖点，500 次构建/月对个人博客远远够用。
• 不备案的原因：备案要求”境内服务器”，Pages 在境外 anycast，两者不同时成立。
• 顺手白嫖：KV + Functions 做阅读量、Web Analytics 做统计、Workers 做 OAuth 中转、Turnstile 防机器人。
• 避开要绑卡的：R2 / Images / Stream / Workers Paid / China Network。
• 小心 Node 版本、包管理器、_headers 文件名这三个构建坑。

现在这个博客从推代码到全球可访问，全程不超过两分钟，成本为零。剩下的时间全用来写东西 —— 这才是博客该有的样子。