用 Astro 和 Cloudflare Workers 搭了这个博客
一个纯静态博客,从建项目到绑定自己的域名,整个流程和踩到的几个坑。
这个博客是一个纯静态站点:用 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
踩到的坑
- API Token 权限要配全。 部署 Worker 需要 Workers Scripts 的编辑权限;如果要绑定自己的域名,还需要对应 Zone 的 Workers Routes 和 DNS 权限。权限不够时,wrangler 只会报一个笼统的认证错误。
workers.dev子域名在国内访问不稳定。 想让国内读者顺畅打开,最好绑定自己的域名。- 中文字体不要从 Google Fonts 加载。 国内访问很慢,直接用系统自带的宋体和苹方,效果反而更稳。
以后写文章,只需要在 src/content/posts/ 下新建一个 Markdown 文件,然后重新部署。