为什么使用自己的 Cloudflare 账号
站点文件发布到你的 Cloudflare Pages 项目,域名、DNS 和证书都在你的账号下。CloudSite 不代持域名,也不把你的站点放在共享主机上。
这也意味着你需要提供 Cloudflare Account ID 和一个具备 Pages 与 DNS 权限的 API Token。
准备 Account ID 和 API Token
- Account ID:Cloudflare 控制台 URL 中的 32 位十六进制字符串。
- Account → Cloudflare Pages → Edit:创建项目、上传文件、管理域名。
- Zone → DNS → Edit:创建或调整 CNAME。
- Zone → Zone → Read:读取域名列表。
- 不要使用 Global API Key;Token 泄露后立即在 Cloudflare 删除。
绑定流程
- 在 CloudSite 设置中填写 Account ID 与 API Token,点击验证。
- 先在 CloudSite 发布站点,确保对应的 Pages 项目存在。
- 在站点详情的域名入口填入域名。
- CloudSite 调用 Cloudflare API 添加自定义域名并创建 CNAME。
- 等待 Cloudflare 签发 HTTPS 证书,状态变为已激活。
域名数量上限
每个 Cloudflare Pages 项目可绑定的域名数量取决于 Cloudflare 套餐:Free 100、Pro 250、Business/Enterprise 500。
CloudSite 把第一个域名作为主域名,其余作为别名;多个域名指向同一内容时,建议设置 canonical 或跳转。
HTTPS 和生效时间
- Cloudflare 自动签发和续期证书,不需要单独购买。
- DNS 生效通常几分钟到几十分钟,取决于缓存和注册商。
- 首次签发证书可能需要几分钟;证书激活后建议使用 Full (strict)。
常见失败原因
- Token 缺少 Pages 或 DNS 权限。
- Account ID 填错,或复制的是 Token 而不是 Account ID。
- 域名未接入当前 Cloudflare 账号,无法自动创建记录。
- 域名已绑定到其他 Pages 项目。
- 存在冲突的 A、AAAA 或 CNAME 记录。