Cloudflare

适用主体

网站开发者、部署与运维工具开发者、边缘应用开发者

接入方式

按资源与权限限定的用户 API Token / 端点兼容时使用账号级 API Token / OAuth 2.0 Authorization Code 用户授权 / 旧式 Global API Key + 邮箱（官方优先推荐 Token）

申请概况

需 Cloudflare 账号及目标 Account/Zone 资源权限；可自建受限 API Token 或开发 OAuth 应用。

• 准备 Cloudflare 账号并确定所用产品；操作网站配置需对应 Zone，Workers 和 KV 等账号资源需正确的 account_id。
• 自己使用的工具优先创建最小权限 API Token，按 Account/User/Zone 和具体资源限制 Read/Edit，按需配置 IP 与有效期。
• 账号级 API Token 可作为不绑定个人用户的服务身份，但需先核对目标端点是否兼容；不能假定与用户 Token 完全通用。
• 面向其他用户的应用可用 OAuth；创建客户端需相关账号的 Super Administrator、Administrator 或 OAuth Client Write 角色。
• OAuth 第三方客户端支持 Authorization Code；浏览器、移动、桌面和 CLI 客户端需 PKCE S256，默认私有客户端只供所属账号成员授权。
• 公开 OAuth 客户端需补齐必需信息并完成客户端 URL 域名 TXT 验证；同时配置所需 scopes、回调与令牌处理。
• 接入受自助服务条款中的受限主体及出口用途规则约束，目录提供的开发入口不构成地区或账号可用保证。

1. 01

   确定产品与资源范围

   先选 DNS、缓存、Worker 或 KV 中实际需要的功能，记录对应账号、Zone 和命名空间标识。

2. 02

   选择 Token 或 OAuth

   个人运维工具创建受限 Token；多用户产品按 OAuth 官方流程配置客户端、scopes、回调和公开条件。

3. 03

   使用独立测试资源

   先做只读查询，再在测试 Zone、独立脚本名或 KV 命名空间验证变更，避免把线上资源当作测试数据。

4. 04

   验证结果并核对费用

   检查具体资源状态和限流响应；清除缓存后访问资产验证，发布前确认 Workers、KV 含量和资源费用。

使用范围与限制

• 此条目只覆盖 DNS、缓存清除、Worker 模块和 KV 管理，不代表已获得 Zero Trust、R2、AI 或其他 Cloudflare 产品的权限。
• API Token 和 OAuth scopes 只授予选定资源与操作范围；Global API Key 为旧式方案，不能据其存在跳过最小权限配置。
• 第三方 OAuth 不支持 Client Credentials、Implicit、密码或 Device Authorization 等其他 grant；公开客户端仍需用户授权。
• 管理 API 的全局限流与缓存清除等端点限制并行生效，控制台和不同凭证的请求也可能累计；不要把 Token 数量当成独立无限额度。
• 缓存清除的成功响应只说明请求被收到，不能单独证明目标内容已被缓存或清除。
• 测试用远端 Zone、Worker 和 KV 仍是真实资源；本地 KV 存储的结果不能证明远端 API 权限、部署或账单行为。
• Workers 与 KV 的免费含量、付费超额和网站套餐分别核对，API 可调用不等于所管理的资源免费。

如何进行开发测试

• 正式管理 API：操作指定账号和 Zone 下的实际配置、Worker 与 KV 资源。
• 开发隔离：建议使用测试 Zone、独立 Worker 名称和 KV 命名空间，并为它们单独限制 Token 范围。
• KV 本地与远端：Wrangler 的 --local、--remote 和 preview 选项需明确区分，不能把本地存储当作远端数据。
• 本次未登录控制台、创建 Token、配置 OAuth 或调用 API，也未确认覆盖全部所述管理端点的统一沙箱。

以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。

1. 01
   创建 Cloudflare API Token已核对官方资料 · 2026-10-15
2. 02
   Cloudflare OAuth 可用范围已核对官方资料 · 2026-10-15
3. 03
   创建 Cloudflare OAuth 客户端已核对官方资料 · 2026-10-15
4. 04
   查询 Cloudflare DNS 记录已核对官方资料 · 2026-10-15
5. 05
   创建 Cloudflare DNS 记录已核对官方资料 · 2026-10-15
6. 06
   Cloudflare Worker 模块上传接口已核对官方资料 · 2026-10-15
7. 07
   Cloudflare 缓存清除方式、可用性与限流已核对官方资料 · 2026-10-15
8. 08
   Cloudflare 缓存清除 API已核对官方资料 · 2026-10-15
9. 09
   Cloudflare KV 命名空间与键值 REST API已核对官方资料 · 2026-10-15
10. 10
    Cloudflare KV 键值写入与权限已核对官方资料 · 2026-10-15
11. 11
    Wrangler KV 命令与本地/远端区分已核对官方资料 · 2026-10-15
12. 12
    Cloudflare Workers 套餐与用量费用已核对官方资料 · 2026-10-15
13. 13
    Cloudflare KV 读写、列表与存储费用已核对官方资料 · 2026-10-15
14. 14
    Cloudflare 管理 API 限流已核对官方资料 · 2026-10-15
15. 15
    Cloudflare 自助服务条款已核对官方资料 · 2026-10-15
16. 16
    Cloudflare API Tokens 后台入口官方入口 · 细则待复核 · 2026-10-15