Cloudflare Pages 基础使用、免费额度与收费额度
Cloudflare Pages 很适合部署前端项目和静态网站。它的核心优势是简单:连接 Git 仓库,设置构建命令,之后每次 push 自动构建和部署。
如果你有 Hexo、Hugo、Astro、Vite、React、Vue、Next.js 静态导出项目,Pages 通常是很省心的选择。
说明:本文额度按 2026-06-07 官方文档整理,后续可能变化。
一、适合哪些项目
Pages 适合:
- 个人博客
- 文档站
- 公司官网
- 前端 SPA
- 静态落地页
- 带少量接口的全栈应用
如果项目主要是 API 服务,应该优先看 Workers。如果项目需要数据库,可以把 Pages 和 D1、KV、R2 组合起来。
二、基础部署流程
最常见的方式是 Git 集成:
- 登录 Cloudflare Dashboard。
- 进入 Workers & Pages。
- 创建 Pages 项目。
- 连接 GitHub 或 GitLab 仓库。
- 选择框架预设或手动填写构建命令。
- 部署完成后绑定自定义域名。
例如 Vite 项目:
1 | npm install |
构建输出目录通常是:
1 | dist |
Hexo 项目通常是:
1 | npm install |
输出目录通常是:
1 | public |
三、用 Wrangler 部署
也可以不用 Git 集成,直接通过 Wrangler 发布:
1 | npm install -g wrangler |
构建后部署:
1 | wrangler pages deploy public --project-name my-site |
这种方式适合 CI/CD 里手动控制部署流程。
四、预览部署
Pages 的一个实用功能是预览部署。每个分支或 Pull Request 都可以生成一个独立预览地址。
这对前端项目很有用:开发、测试、产品都可以直接看页面,不需要把分支代码部署到正式域名。
五、免费额度
Cloudflare Pages Free 计划常见限制:
- 每月 500 次构建
- 1 个并发构建
- 构建超时 20 分钟
- 单文件最大 25 MiB
- 每个项目最多 20,000 个文件
- 自定义域名数量有限制
对个人博客、文档站、小型前端项目来说,这个额度通常足够。
六、收费额度
Pages 的付费能力和 Cloudflare 账号计划有关。
Pro 计划常见额度:
- 每月 5,000 次构建
- 5 个并发构建
- 每个项目最多 100,000 个文件
Business 计划常见额度:
- 每月 20,000 次构建
- 20 个并发构建
- 每个项目最多 100,000 个文件
如果你在 Pages 里使用 Functions,函数请求会按 Workers 计费,不应该只看 Pages 构建次数。
七、Pages Functions
Pages 不只能托管静态文件,也可以写函数。
目录结构示例:
1 | functions/ |
函数示例:
1 | export function onRequest() { |
访问路径:
1 | /api/hello |
如果接口越来越复杂,建议直接用 Workers 项目管理后端逻辑。
八、实践建议
Pages 最适合做前端入口。静态页面交给 Pages,后端 API 交给 Workers,结构化数据交给 D1,文件交给 R2。
如果只是博客或文档站,Free 计划通常就够。如果团队有大量分支预览、频繁构建、多个前端项目,就要关注构建次数和并发构建数量。
参考资料
- Cloudflare Pages: https://developers.cloudflare.com/pages/
- Pages Limits: https://developers.cloudflare.com/pages/platform/limits/
- Pages Functions: https://developers.cloudflare.com/pages/functions/