Article / 2026/05/28

Cloudflare Pages 部署要点

Astro 静态博客部署到 Cloudflare Pages 时需要关注的环境变量、构建命令和自动部署配置。

构建命令

本项目的构建命令是:

npm run build

它会先执行 astro build,再用 Pagefind 为 dist 目录生成搜索索引。

输出目录

Cloudflare Pages 的输出目录设置为:

dist

GitHub Actions

仓库里已经包含 .github/workflows/deploy.yml。你需要在 GitHub 仓库设置里添加这些 secrets:

  • CLOUDFLARE_API_TOKEN
  • CLOUDFLARE_ACCOUNT_ID

同时在 workflow 里把 projectName 改成你的 Cloudflare Pages 项目名。

Giscus 未启用:请在 src/site.config.ts 中配置 repoId 与 categoryId。