约 1 分钟读完

用 Astro 和 Cloudflare Workers 搭了这个博客

一个纯静态博客,从建项目到绑定自己的域名,整个流程和踩到的几个坑。

建站AstroCloudflare

这个博客是一个纯静态站点:用 Astro 生成 HTML,再交给 Cloudflare Workers 的静态资源托管来分发。没有数据库,没有服务器要维护,写文章就是写 Markdown。

为什么选 Astro

Astro 默认输出零 JavaScript 的静态页面,内容集合(Content Collections)可以直接读取一个文件夹里的 Markdown,并用 schema 校验 frontmatter。少写一个字段,构建时就会报错,不会等到上线后才发现。

文章的 frontmatter 长这样:

title: 文章标题
description: 一句话摘要,会出现在列表和 RSS 里
date: 2026-11-22
tags: [标签一, 标签二]
draft: false

为什么是 Workers 而不是 Pages

Cloudflare 现在推荐用 Workers 的静态资源(Static Assets)来托管静态网站,功能上和 Pages 基本一致,而且以后想加一点服务端逻辑(比如表单、短链)可以直接写在同一个 Worker 里。

配置只有几行:

{
  "name": "truthsbetold-blog",
  "assets": {
    "directory": "./dist",
    "not_found_handling": "404-page"
  }
}

部署命令:

npm run build
npx wrangler deploy

踩到的坑

  1. API Token 权限要配全。 部署 Worker 需要 Workers Scripts 的编辑权限;如果要绑定自己的域名,还需要对应 Zone 的 Workers Routes 和 DNS 权限。权限不够时,wrangler 只会报一个笼统的认证错误。
  2. workers.dev 子域名在国内访问不稳定。 想让国内读者顺畅打开,最好绑定自己的域名。
  3. 中文字体不要从 Google Fonts 加载。 国内访问很慢,直接用系统自带的宋体和苹方,效果反而更稳。

以后写文章,只需要在 src/content/posts/ 下新建一个 Markdown 文件,然后重新部署。