关联您的 Cloudflare 账户以使用 Pages、CDN 和 DNS

连接后能为您实现的功能

连接您的 Cloudflare 账户后，我们可以将静态站点发布到您账户下的 Cloudflare Pages，并通过它为您站点的 DNS 和缓存提供服务。所有内容都保留在您自己的 Cloudflare 控制面板和您自己的 Cloudflare 方案中。

开始之前

需要一个 Cloudflare 账户，并将您想要使用的域名作为区域（zone）添加到其中。免费方案足以建立连接；您在每个区域上能执行的操作取决于您的方案权限。

1. 在 Cloudflare 创建密钥

在 Cloudflare 控制面板中打开我的个人资料 → API 令牌，选择创建令牌，然后选择创建自定义令牌。为其命名，添加以下权限，并在区域资源下选择您希望我们访问的区域——所有区域，或仅限您指定的区域。检查无误后点击创建令牌。Cloudflare 仅会显示一次该令牌；请及时复制。

添加以下权限：

• 区域 → 区域 → 读取
• 区域 → DNS → 编辑
• 区域 → 清除缓存 → 清除
• 区域 → 区域设置 → 编辑
• 账户 → Cloudflare Pages → 编辑——仅在您需要我们向 Pages 发布站点时添加。未包含此权限的令牌仍可连接，并可用于 DNS 和缓存。

较旧的替代方式。除了令牌之外，您也可以使用您的 Global API Key 以及您的登录邮箱地址进行连接（我的个人资料 → API 令牌 → API 密钥 → Global API Key → 查看）。Cloudflare 不建议这样做：Global API Key 拥有您登录账户在所有区域上的全部权限，且无法限制范围。如果可以，请使用令牌。

2. 在此处进行连接

在您的控制面板中打开集成，然后选择连接账户。选择 Cloudflare 账户 (Pages, CDN & DNS) 作为分组，选择 Cloudflare 作为账户，填写 API 令牌——或者使用较旧的替代方式，填写 API 密钥与账户邮箱，然后点击连接账户。

在保存任何内容之前，我们会测试您粘贴的信息。无法使用的密钥绝不会被存储，并且系统会提示具体错误原因。可正常使用的密钥将加密保存在我们的机密保险库中——绝不会存入我们的数据库——且不会再次显示，即使对您也是如此。

后续步骤

• 当您创建或迁移静态站点时，Cloudflare Pages 会作为部署目标出现，我们会将构建成果发布到您账户下的 Pages 项目中。
• 您的区域可以通过此账户为一个域名的 DNS 和站点的缓存提供服务。
• 我们会检查该令牌是否具备读取区域、编辑 DNS、清除缓存以及修改区域设置的权限。连接旁边的核对清单会显示我们已确认的权限。

如果您希望将 CDN 和 DNS 分别保留在不同的 Cloudflare 账户中，请分别作为 Cloudflare CDN 和 Cloudflare DNS 进行连接——它们各自有独立的指南。

如果连接失败

某项权限显示为未确认。 Cloudflare 并不总是允许令牌列出自身的权限，因此某些权限会在我们首次使用它们时予以确认。如果后续操作因权限错误而失败，请在我的个人资料 → API 令牌中编辑该令牌并添加缺失的权限——令牌的值不会改变，因此无需重新连接。

缺少某个区域。该令牌的区域资源未包含该区域。请编辑令牌以包含该区域，或包含所有区域。

提示密钥被拒绝。几乎总是以下三种情况之一：复制时混入了空格或换行符、密钥已过期，或者密钥在您复制后被吊销或重新生成。请创建一个新密钥并重新粘贴。

已成功连接，但后续某些操作失败。密钥通过了身份验证，但缺少该操作所需的权限。请使用上方列出的权限创建一个新密钥，然后断开旧连接并连接新密钥。

断开连接

打开集成，找到该账户并点击断开连接。这会立即删除存储的密钥。任何正在使用该密钥的操作都会在其下一次运行时停止，并且依赖它的界面会明确显示此状态，而不会静默失败。

断开连接不会撤销已经完成的操作——我们在您账户上更改过的记录、部署或设置将保持原样。如果您认为密钥本身可能已泄露，还应在供应商处将其吊销；断开连接仅会删除我们保存的副本，而不会删除供应商处的副本。