用 Astro 和 Cloudflare Workers 快速搭建个人博客

静态文件从哪来#

Cloudflare 不会替你跑 Astro。Markdown 变成 HTML、RSS、sitemap，以及站点若启用了搜索索引，都发生在本机构建。开发服务器可以预览草稿；搜索和正式的绝对链接，要看生产构建后的结果。

按项目文档安装 Node.js 和包管理器。构建完成后，输出目录里已经是可以直接提供的静态文件。接下来的发布，只是把这份目录送上边缘节点。

Worker 和 Wrangler 是什么#

Cloudflare 是一张全球边缘网络。Worker 是这张网上一个有名字的服务。Wrangler 是本机命令行工具，用来登录账号并把文件推上去。

传统 Worker 是一段在边缘执行的 JavaScript。静态博客通常更简单：不必手写请求处理脚本，只让 Worker 托管构建产物。访客访问时，没有一台长期开着的博客虚拟机；就近的节点按 URL 路径返回静态文件。

配置和发布命令#

对应配置可以写成：

1
{
2
  "name": "my-blog",
3
  "compatibility_date": "2024-12-01",
4
  "assets": {
5
    "directory": "./dist",
6
    "not_found_handling": "404-page"
7
  }
8
}

name 是 Cloudflare 账号里的服务名，也是免费链接的第一段，换成你自己的名字即可。assets.directory 指定上传目录，按你的构建输出修改。not_found_handling 为 404-page 时，未知路径返回站点自己的 404 页面，而不是平台默认报错页。compatibility_date 锁定运行时功能集，避免平台升级后行为悄悄变化，日期按你创建项目时选取。

没有 main 入口脚本。这是静态资产托管，不是手写 fetch 处理器。Cloudflare 对 Astro 静态站接到 Workers 的说明见官方框架指南。

发布用的命令不必写进项目依赖，可以临时拉取最新 CLI：

1
pnpm build
2
pnpm dlx wrangler@latest login
3
pnpm dlx wrangler@latest deploy

若项目用 npm 或 yarn，把构建命令换成项目里实际的脚本即可。login 会打开浏览器，把本机授权到 Cloudflare 账号。deploy 读取上面的配置并上传。本机若要模拟 Cloudflare 的路由（包括自定义 404），可以用 pnpm dlx wrangler@latest dev --local，它和 pnpm dev 不是同一件事。

构建和部署必须分开。没有构建产物就部署，会失败或发上一份空内容。改了文章却只部署、没有重新构建，线上仍是旧站。

实名和注册#

托管通了之后，才处理自己的 .com。在国内注册商（例如阿里云）买通用域名，通常要先完成账号实名，再准备已实名的域名信息模板，下单时选它。账号实名回答「这个云账号是谁的」，域名实名回答「这个名字登记在谁名下」。核验没过之前，解析和自定义域会卡住。以阿里云为例，官方说明见个人实名认证和通用域名实名核验。

买域名时不要先在注册商的解析面板里加 A 记录。接下来会把 DNS 服务器改成 Cloudflare。

把解析交给 Cloudflare#

若域名已经打开 DNSSEC，改 NS 之前先关掉：父域仍留着旧的 DS 记录、子域已经换成新解析商时，解析可能直接失败。

在 Cloudflare 添加站点时填根域名，例如 example.com，不要填 www.example.com。它会分配两个 *.ns.cloudflare.com。回到注册商，把该域名的 DNS 服务器改成这两行，逐字母核对，不要抄其他账号的 NS。阿里云的说明见修改 DNS 服务器；Cloudflare 见 Full setup。

注册商可能提示最长 48 小时。新域名常见几分钟到几小时。站点状态变为 Active 后，可以把域名换成自己的再查：

1
dig NS example.com +short

结果应是 Cloudflare 那两个 NS。若仍是注册商原来的 DNS 主机名，就再等，也不要同时在两边加 A 记录。

绑到同一个 Worker#

然后在 Worker 的 Domains & Routes 里添加 Custom Domain，填根域名。Cloudflare 会自己建 DNS 记录并签发证书，不必先手写一条指到别处的 CNAME，也不必另买 SSL。加密模式使用 Full (strict)。若也要 www，再加一次自定义域。官方说明见 Workers Custom Domains。

workers.dev 和自定义域指向同一个 Worker。加自己的域名不会新建第二份站点。