| name | cloudflare-pages |
| description | Cloudflare Pages 静态网站部署,支持命令行一键部署、API 部署、项目管理 |
Cloudflare Pages 部署
通过 wrangler CLI 将静态网站部署到 Cloudflare Pages。
环境配置
已配置在 ~/.zshrc:
export CLOUDFLARE_API_TOKEN="7lVFRUKBA-wK0I95hkgNBX8_cz-b9v4MjK777LCR"
export CLOUDFLARE_ACCOUNT_ID="686f72167174a0d1017c4a9fb4786ed6"
部署命令
cd <项目目录> && npx wrangler pages deploy . --project-name=<项目名>
npx wrangler pages deploy . --project-name=<项目名> --branch=main --commit-message='描述'
注意事项
- 必须设置 CLOUDFLARE_ACCOUNT_ID:不设置的话 wrangler 会去调
/user API 导致 403 错误后中断
- wrangler 通过 npx 调用,不需要全局安装
- 每次部署会创建新版本,自动覆盖旧版本
- 免费套餐:无限带宽、每月500次构建、支持自定义域名和自动 HTTPS
已有项目
API 方式查询
curl -s 'https://api.cloudflare.com/client/v4/accounts/686f72167174a0d1017c4a9fb4786ed6/pages/projects' \
-H 'Authorization: Bearer $CLOUDFLARE_API_TOKEN' | jq '.result[]?.name'
踩坑记录
- Global API Key 不能用于 wrangler:必须创建 API Token(在 Profile > API Tokens 页面),权限需要 Account > Cloudflare Pages > Edit
- wrangler 调 /user 返回 403:Token 没有 User > User Details > Read 权限时会出现,解决办法是设置
CLOUDFLARE_ACCOUNT_ID 环境变量绕过
- 浏览器缓存:部署后用户需要 Cmd+Shift+R 强制刷新才能看到最新版本