连接您的 Cloudflare 账户以使用 Pages、CDN 和 DNS

连接此服务能为您带来什么

连接您的 Cloudflare 账户后，我们可以将静态网站发布到您账户中的 Cloudflare Pages 上，并由其提供网站的 DNS 和缓存服务。所有内容都存储在您自己的 Cloudflare 仪表盘和您自己的 Cloudflare 套餐中。

开始之前

您需要一个 Cloudflare 账户，并将您要使用的域名作为区域（Zones）添加到其中。免费套餐即可满足连接要求；您在每个区域上可执行的操作取决于您的套餐允许的功能。

1. 在 Cloudflare 中创建密钥

在 Cloudflare 仪表盘中打开 My Profile → API Tokens 并选择 Create Token，然后选择 Create Custom Token。为令牌命名，添加以下权限，并在 Zone Resources 下选择您希望我们访问的区域 —— 可以是所有区域，也可以仅限您指定的区域。检查无误后，点击 Create Token。Cloudflare 仅会显示一次该令牌，请务必在此复制。

添加以下权限：

• Zone → Zone → Read
• Zone → DNS → Edit
• Zone → Cache Purge → Purge
• Zone → Zone Settings → Edit
• Account → Cloudflare Pages → Edit —— 仅当您希望我们向 Pages 发布网站时需要。没有此权限的令牌仍然可以连接并适用于 DNS 和缓存。

较旧的替代方案。 除了使用令牌，您还可以使用您的 Global API Key 以及您登录时使用的电子邮件地址（My Profile → API Tokens → API Keys → Global API Key → View）进行连接。Cloudflare 不建议这样做：Global API Key 拥有您登录账户在所有区域上的所有权限，且无法缩小范围。如果可以，请使用令牌。

2. 在此处进行连接

在仪表盘中打开 Integrations 并选择 Connect an account。选择 Cloudflare account (Pages, CDN & DNS) 作为分组，选择 Cloudflare 作为账户，填写 API token（或者对于较旧的替代方案，填写 API key 和 Account email），然后点击 Connect account。

在保存任何内容之前，我们会对您粘贴的内容进行测试。无法正常工作的密钥绝不会被存储，系统会提示具体错误原因。正常工作的密钥将加密保存在我们的密钥保管库中（绝不保存在数据库中），并且再也不会显示，即使对您也是如此。

接下来会发生什么

• 当您创建或迁移静态网站时，Cloudflare Pages 将显示为部署目标，我们会将构建版本发布到您账户中的 Pages 项目上。
• 您的区域可以通过此账户提供域名的 DNS 和网站的缓存。
• 我们会检查该令牌是否能够读取您的区域、编辑 DNS、清除缓存以及更改区域设置。连接旁边的检查清单会显示我们能够确认的权限。

如果您希望将 CDN 和 DNS 保留在不同的 Cloudflare 账户中，请分别将其连接为 Cloudflare CDN 和 Cloudflare DNS —— 每个服务都有其专属的指南。

如果连接失败

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

某个区域缺失。 令牌的 Zone Resources 中未包含该区域。请编辑令牌以包含该区域或所有区域。

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

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

断开连接

打开 Integrations，找到该账户并点击 Disconnect。这将立即删除存储的密钥。任何正在使用该密钥的内容将在下一次操作时停止，并且依赖于它的屏幕会明确提示错误，而不是默默失败。

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