Kirito's Blog · 文章

用 GitHub Actions 自动部署博客到 Cloudflare Pages

2026-02-05 · 1 分钟 ·标签：GitHubCI/CD部署

从 push 到上线：构建、环境变量、Pages 项目与常见报错排查。

你想要的体验应该是：写完 Markdown -> git push -> 自动上线。

需要准备什么

  • 一个 Cloudflare Pages 项目
  • API Token（最小权限）
  • GitHub Secrets 配置

工作流核心

工作流做三件事：

Text
checkout -> npm ci -> node blog/build.mjs -> pages deploy

Secrets 清单

  • CLOUDFLARE_API_TOKEN
  • CLOUDFLARE_ACCOUNT_ID
  • CLOUDFLARE_PAGES_PROJECT

可选：

  • SITE_BASE_URL（用于 canonical/sitemap/robots）
  • GISCUS_*（用于评论）

常见问题

  • 构建成功但页面旧：检查缓存规则/清理缓存
  • 评论不显示：检查 Giscus repo id/category id 是否填对