Cloudflare Pages 基础使用、免费额度与收费额度
wxk1991 Lv5

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 集成:

  1. 登录 Cloudflare Dashboard。
  2. 进入 Workers & Pages。
  3. 创建 Pages 项目。
  4. 连接 GitHub 或 GitLab 仓库。
  5. 选择框架预设或手动填写构建命令。
  6. 部署完成后绑定自定义域名。

例如 Vite 项目:

1
2
npm install
npm run build

构建输出目录通常是:

1
dist

Hexo 项目通常是:

1
2
npm install
npm run build

输出目录通常是:

1
public

三、用 Wrangler 部署

也可以不用 Git 集成,直接通过 Wrangler 发布:

1
2
npm install -g wrangler
wrangler login

构建后部署:

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
2
3
functions/
api/
hello.ts

函数示例:

1
2
3
export function onRequest() {
return Response.json({ message: "hello pages" });
}

访问路径:

1
/api/hello

如果接口越来越复杂,建议直接用 Workers 项目管理后端逻辑。


八、实践建议

Pages 最适合做前端入口。静态页面交给 Pages,后端 API 交给 Workers,结构化数据交给 D1,文件交给 R2。

如果只是博客或文档站,Free 计划通常就够。如果团队有大量分支预览、频繁构建、多个前端项目,就要关注构建次数和并发构建数量。


参考资料