这是什么
Cloudflare Pages 是 Cloudflare 的静态站与全栈前端部署服务。免费档的数字在官方文档里写得很清楚:每月 500 次构建、静态请求不限量、每账号最多 100 个项目。对个人站和文档站来说,「静态请求不限量」是它比别家更耐用的地方——流量再大,静态部分不另外收钱也不限次。
本站已实领在用。它和 Workers 是一家的两本账:Pages 管静态托管和构建,动态函数部分(Pages Functions)走 Workers 的额度,申请前先把这层关系看清,下面会细说。
怎么申请
- 用 Cloudflare 账号登录。 打开 pages.cloudflare.com,没有账号先邮箱注册,不绑卡。正常几分钟。
- 创建项目:连 Git 仓库或直接上传。 两条路:一是关联 GitHub/GitLab 仓库,推代码自动构建部署;二是直接把打包好的静态文件拖上去。准备:一个仓库或一份构建好的静态文件。第一次建议先拿一个现成静态页走通全流程,正常十几分钟。卡住最常见的原因是构建命令和输出目录填错——框架预设选对(或手动填对 build 命令和 dist 目录),构建日志里能看到具体死在哪一步。
- 部署成功后绑自定义域名。 控制台里给项目加自定义域名,域名本身在 Cloudflare DNS 上的话验证自动完成;外部 DNS 要按提示加记录。绑完等证书签发,几分钟到几十分钟。
- 回控制台确认用量口径。 看一眼本月已用构建次数和项目数,心里有本账:500 次构建是所有项目共享的月池子,不是每个项目 500 次。
拿到后怎么用
- 构建次数是全账号共享的月池子。 每月 500 次,所有项目、所有分支的构建都从这里扣。提交频繁的仓库一天能烧几十次,预览部署(每个 PR 自动起一个预览)也在扣——PR 多的仓库先把预览构建的触发范围收紧。
- 静态请求不限量,动态函数另算。 纯静态站随便跑;一旦用了 Pages Functions(动态接口、 SSR 之类),那部分按 Workers 免费档口径走:每天 10 万次请求、单次 10 毫秒 CPU。设计时能静态就静态,动态只留必要的接口。
- 每次推送都是一次构建。 写文档、改错别字也算。攒一批改动再推,比改一个字推一次省得多;本地先构建验证过再推,能少烧很多次失败构建。
- 回滚是现成的。 部署列表里能一键回到任意历史版本,上线翻车先回滚再慢慢查,比重新构建快。
额度
- 构建:每月 500 次(全账号共享)。
- 静态请求:不限量。
- 项目数:每账号 100 个。
限制
- 500 次构建按月算,频繁自动构建的 monorepo 要省着点触发。
- 动态部分走 Workers/Pages Functions,其额度另按 Workers 免费档口径(每天 10 万次请求、单次 10 毫秒 CPU),别混算。
- 单个项目的部署文件大小、文件数等细项限制以官方文档为准,大站迁移前先对一遍。
容易卡住的地方
- 构建失败:先看构建日志定位——十有八九是构建命令、输出目录或 Node 版本不对。框架预设选对能解决大半;本地能构建通过的配置,照着填到控制台。
- 构建次数掉得飞快:多半是预览部署在吃——每个 PR、每个分支推送都在构建。去项目设置里收紧预览构建的分支范围,或关掉不需要的自动预览。
- 自定义域名证书迟迟不签发:先确认 DNS 记录按控制台提示加对了,域名在 Cloudflare 托管的话一般自动完成;外部 DNS 常见问题是多了一条冲突的旧记录。
- 页面更新了但访问还是旧版:先确认新部署真的成功(部署列表里是最新一次且状态成功),再怀疑缓存——Pages 的部署是原子切换的,部署没成功时线上还是旧版。
避坑
- 预览部署也吃构建次数:PR 多的仓库,先确认预览构建的触发规则再开自动部署。
- 自定义域名直接走 Cloudflare DNS 最省事,外部 DNS 接入按官方文档做验证。
- 500 次是全账号的账,别给一个玩具项目开无节制的自动构建,把正经站的额度挤没了。
以上信息以官方页面为准,申请前请打开官网再核对一次。
常见问题
Cloudflare Pages 免费档每月多少次构建?
500 次构建(全账号共享),静态请求不限量,每账号 100 个项目。
Cloudflare Pages 要绑卡吗?
不要,Cloudflare 账号邮箱注册即可。
Pages 和 Workers 的额度是一回事吗?
不是。Pages 静态部分按 Pages 口径(构建次数、静态请求不限量),函数部分按 Workers 免费档口径(每天 10 万次请求),分别计算。
预览部署消耗构建次数吗?
消耗。每个 PR 或分支触发的预览构建都从每月 500 次里扣,PR 多的仓库要在设置里收紧触发范围。
Pages 能跑动态网站吗?
能,用 Pages Functions 写动态接口,但那部分按 Workers 免费档计量(每天 10 万次请求、单次 10 毫秒 CPU)。重后端、全动态的站不适合放这里,纯静态和轻动态是它的主场。
构建失败了从哪查?
控制台的部署记录里有完整构建日志,命令、目录、依赖安装死在哪一步都写着。先在本地按同样的命令构建一遍,能复现就好定位。