前置准备#

• Node.js >= 20，推荐使用 pnpm 作为包管理器
• GitHub 账号
• Cloudflare 账号
• 一个 Fuwari 博客项目（还没有？运行 pnpm create fuwari@latest）

第一步：初始化 Git 仓库并推送到 GitHub#

如果你的项目还没有 Git 仓库，先初始化：

1
git init
2
git add -A
3
git commit -m "feat: initial commit"

在 GitHub 上创建一个新仓库。注意：不要勾选 “Add a README file”、“Add .gitignore” 或 “Choose a license”——你的项目已经有这些文件了。

创建完成后，关联远程仓库并推送：

1
git remote add origin https://github.com/<你的用户名>/<仓库名>.git
2
git branch -M main
3
git push -u origin main

第二步：配置 astro.config.mjs#

部署前需要设置正确的站点 URL。编辑 astro.config.mjs：

1
export default defineConfig({
2
  site: "https://<你的项目名>.pages.dev",
3
  // ...
4
});

如果你有自己的域名，稍后可以换成自定义域名。这里先用 Cloudflare Pages 默认提供的 .pages.dev 域名作为占位。

第三步：连接 Cloudflare Pages#

1. 登录 Cloudflare Dashboard
2. 左侧导航找到 Workers & Pages → Pages → 点击 连接到 Git
3. 授权 Cloudflare 访问你的 GitHub 账号，选择刚才创建的仓库
4. 配置构建参数：

5. 点击 保存并部署

第四步：等待构建完成#

Cloudflare 会自动拉取你的代码、安装依赖、执行构建。整个过程通常 2-3 分钟。

构建日志中你会看到：

1
Running Pagefind v1.4.0 (Extended)
2
Indexed 1 language
3
Indexed 2 pages
4
Finished in 0.275 seconds

看到这些说明构建成功，Pagefind 搜索索引也生成了。

常见问题#

1
"packageManager": "pnpm@9.0.0"

1
pnpm add sharp
2
git add package.json pnpm-lock.yaml
3
git commit -m "fix: add sharp for image optimization"
4
git push

第五步：绑定自定义域名（可选）#

1. Cloudflare Pages 项目 → 自定义域 → 输入你的域名（如 blog.example.com）
2. Cloudflare 自动配置 DNS 记录（前提是域名在 Cloudflare 管理）
3. 等待 SSL 证书自动签发

如果域名不在 Cloudflare 管理，需要手动添加 CNAME 记录指向 <项目名>.pages.dev。

第六步：更新站点 URL#

域名确定后，更新 astro.config.mjs 中的 site 字段：

1
site: "https://你的实际域名.com",

提交并推送，Cloudflare 自动重新部署：

1
git add astro.config.mjs
2
git commit -m "fix: update site url to custom domain"
3
git push

日常使用#

部署完成后，日常写文章只需三步：

1
pnpm new-post 文章标题
2
# 编辑 src/content/posts/文章标题.md
3
git add -A && git commit -m "post: 新文章"
4
git push

每次 push 到 GitHub，Cloudflare Pages 会自动检测并触发构建部署。

总结#

Fuwari 是纯静态站点，部署到 Cloudflare Pages 几乎是零配置。整个流程核心就两步：推代码到 GitHub → Cloudflare Pages 连接仓库。相比 VPS 部署，不需要维护服务器，免费 tier 对个人博客完全够用，HTTPS 和 CDN 自动配备。