# Cloudflare 集成：用限定权限的令牌管理您的 DNS

> 把 Cloudflare 域名区域连接到 Pilotiko：使用仅限单一域名 DNS 权限的令牌，内置即时快照、邮件验证与一键回退功能，操作安全可控，设置简单省心，让网站上线更放心。

更新于 2026年11月8日 · https://app.pilotiko.com/zh/integrations/cloudflare

借助仅限于您域名 DNS 的 Cloudflare API 令牌，Pilotiko 可读取您的记录、保存一份即时快照，并在您确认的切换操作中替换网站的相关记录。状态：已提供。

## 要点
- 使用「Edit zone DNS」模板创建的令牌，仅限单一域名区域。
- 令牌只粘贴一次，加密保存，之后不会再次显示。
- Pilotiko 创建的记录为「仅 DNS」模式（灰色云朵）。
- 域名切换始终是需要您亲自确认的一步。

## Cloudflare 连接有什么作用？

它让 Pilotiko 只能访问单一区域的 DNS，权限足以读取和替换记录，您的 Cloudflare 账户中的其他内容一概无法触及。

Cloudflare 没有针对这种用途的一键授权，需要创建 API 令牌。在您的 Cloudflare 个人资料中，令牌页面提供名为「Edit zone DNS」的模板，每个令牌都可限定到特定区域；未包含的区域会返回错误 [1]。Pilotiko 只要求这一最低权限：仅针对相关域名的「Zone · DNS · 修改」权限。

凭借这个令牌，连接器会验证对该区域的访问权限、读取所有记录，然后通过 Cloudflare 的 DNS 记录 API [3] 替换或删除与您网站相关的记录。它不会触碰防火墙、缓存或账单。

重点：Pilotiko 创建的记录采用「仅 DNS」模式。在代理模式（橙色云朵）下，请求得到的是 Cloudflare 的地址；在仅 DNS 模式（灰色云朵）下，请求得到的是服务器的真实地址 [2]。Pilotiko 需要被直接访问，才能证明它在为您的域名提供服务并获取 HTTPS 证书。

- **所需权限**：Zone · DNS · 修改，限定于单一区域。
- **读取**：该区域的所有记录（类型、名称、值、缓存时长、代理状态）。
- **写入**：仅在切换时写入根域名和 www 的 A、AAAA 或 CNAME 记录。
- **等待您的同意**：域名切换，是过渡流程中的手动步骤。

## 如何把 Cloudflare 连接到 Pilotiko？

1. **打开 API 令牌页面** — 在 Cloudflare 中，进入「我的个人资料」，再进入「API 令牌」，然后选择「创建令牌」。
2. **从「Edit zone DNS」模板开始** — 保留 Zone · DNS · 修改权限，不要添加其他权限。
3. **限定区域** — 在资源中，只选择 Pilotiko 需要服务的域名。不要授予「所有区域」。
4. **立即复制令牌** — Cloudflare 只显示一次密钥。请在过渡流程的「访问域名 DNS」步骤中把它粘贴到 Pilotiko；令牌会被验证、加密，然后永久隐藏。
5. **查看快照与计划** — Pilotiko 会记住您当前的记录，并在切换前准确告诉您它将更改什么。

## 哪些功能已提供，哪些即将推出？

| 功能 | 状态 | 详情 |
|---|---|---|
| 无需连接的 DNS 与 HTTPS 检查 | 已提供 | 由 Pilotiko 公开读取，无需令牌 |
| 验证令牌对区域的访问权限 | 已提供 | 确认令牌确实能访问该区域 |
| 读取并保存记录 | 已提供 | 任何更改之前先生成快照 |
| 替换或删除网站记录 | 已提供 | 始终为灰色云朵；精确回退 |
| 代理、缓存或防火墙设置 | 即将推出 | 尚未开发；超出所申请的权限范围 |
| 域名购买或转移 | 即将推出 | 尚未对接任何域名注册商 |

## 通过 Cloudflare 切换域名，具体会改变什么？

**示例：加蒂诺一家水管工的 Cloudflare 区域，共 14 条记录**

该区域包含托管在主机商的网站、外部服务商提供的邮件，以及一个预订子域名。网站的两条记录都启用了代理。

- 已读取并保存的记录 : 14
- 切换时修改的记录 : 2（根域名和 www）
- 涉及的邮件记录 : 0（MX 和 SPF 保持不变）
- 切换前的缓存时长 : 降至 600 秒
- 2 条新记录的代理状态 : 仅 DNS
- 回退时恢复的记录 : 2 条，恢复为之前的代理状态
- **= 14 条记录中有 2 条发生变化；回退会恢复这 2 条的原始值，包括它们的橙色云朵。**

## 您的数据如何受到保护，又如何撤销访问权限？

令牌静态加密（AES-256-GCM），绝不会离开 Pilotiko 的服务器。DNS 记录属于技术性数据，但快照可能暴露服务名称或人员姓名。魁北克法律要求根据信息的敏感程度采取合理的安全措施（第 10 条），并在向魁北克境外传输个人信息之前进行隐私因素评估（第 17 条）[4]。魁北克信息获取委员会对《Loi 25》（第 25 号法）的这些变化做了概述 [5]。另请参阅我们的[安全页面](/securite)。

撤销访问权限有两种方式：在 Pilotiko 中选择「断开连接」，令牌会被删除，且该操作会记录在审计日志中；在 Cloudflare 中，到您创建令牌的页面删除该令牌，此后即使别处仍有副本，Pilotiko 的任何请求也无法通过。

## Cloudflare 有哪些特有的限制？

您的域名在 GoDaddy？请查看 [GoDaddy 集成](https://app.pilotiko.com/zh/integrations/godaddy)。旧网站的内容由 [WordPress 集成](https://app.pilotiko.com/zh/integrations/wordpress)读取，过往预约由 [Acuity Scheduling](https://app.pilotiko.com/zh/integrations/acuity-scheduling) 读取。完整表格：[所有集成](https://app.pilotiko.com/zh/integrations)。

- 有意接受的取舍：Cloudflare 仅建议对不承载网页流量的记录使用仅 DNS 模式 [2]。因此，由 Pilotiko 提供服务的网站记录将失去 Cloudflare 代理的防护与缓存。
- 授予「所有区域」的令牌虽然可以使用，但 Pilotiko 会要求您限定范围：权限过宽的令牌是不必要的风险。
- 如果 MX 或某个邮件别名（mail、smtp、imap、webmail、autodiscover）指向与网站相同的服务器，切换会被阻止，Pilotiko 会在继续之前给出修正建议。

## 常见问题

### 为什么 Pilotiko 不保留橙色云朵？

Pilotiko 需要被直接访问，才能证明它在为您的域名提供服务并获取 HTTPS 证书，因此它以仅 DNS 模式创建记录。它读取到的代理模式记录，会在快照中如实保留。

### 这个令牌能修改我账户中的其他域名吗？

只要像 Cloudflare 允许的那样把它限定在单一区域就不会。其他区域会返回错误。Pilotiko 建议您绝不要授予所有区域。

### 切换期间我的邮件会中断吗？

Pilotiko 在更改任何内容之前，会先检查 MX 和邮件别名。如果邮件依赖与网站相同的服务器，切换会被阻止，并提供具体的修正建议。

### 如果我丢失了令牌怎么办？

Cloudflare 只显示一次密钥。请用相同的限制创建一个新令牌，粘贴到 Pilotiko，然后在 Cloudflare 中删除旧令牌。

### 我可以取消切换吗？

可以。反向计划会恢复快照中的记录，包括其原始的值、缓存时长和代理状态。

### 需要 Cloudflare 的付费方案吗？

Pilotiko 只使用 DNS API 和 API 令牌。我们不公布兼容的 Cloudflare 方案清单：请在您的账户中确认能否创建限定到单一区域的令牌。

## 资料来源

1. Cloudflare Docs, « Create API token », https://developers.cloudflare.com/fundamentals/api/get-started/create-token/ (查阅于 2026-10-15)
2. Cloudflare Docs, « Proxy status », https://developers.cloudflare.com/dns/proxy-status/ (查阅于 2026-10-15)
3. Cloudflare Docs, « API reference: DNS records », https://developers.cloudflare.com/api/resources/dns/subresources/records/ (查阅于 2026-10-15)
4. LégisQuébec, « Loi sur la protection des renseignements personnels dans le secteur privé (RLRQ, c. P-39.1) », https://www.legisquebec.gouv.qc.ca/fr/document/lc/P-39.1 (查阅于 2026-10-15)
5. Commission d'accès à l'information du Québec, « Principaux changements apportés par la Loi 25 », https://www.cai.gouv.qc.ca/protection-renseignements-personnels/sujets-et-domaines-dinteret/principaux-changements-loi-25 (查阅于 2026-10-15)
