使用说明

三步配好 Token,再附一份报错对照表和记录类型速查。

1

建一个 API Token

打开 API Tokens 页面, 点 Create Token → Create Custom Token。

2

勾对权限

按下面那张表勾。少勾 Zone:Read,域名列表就会是空的 —— 这是最常见的坑。

3

粘进设置页

点「保存并验证」,看到四项检查全绿就可以回总览页刷域名了。

权限清单

Custom Token 里逐条添加,Account Resources / Zone Resources 都选你要管的范围。

权限组级别为什么需要
Zone → ZoneRead读域名列表与域名详情。缺了它 /zones 返回空数组。
Zone → DNSEdit解析记录的增删改查。
Zone → Cache PurgePurge清理边缘缓存。
Zone → Zone SettingsEdit改 SSL、Always Use HTTPS、开发模式等开关。
Account → Account SettingsRead可选。读账户信息与 DNS 设置,诊断更准。

只想看不想改?把 DNS 和 Zone Settings 的级别降成 Read,页面上的写操作按钮会报 9109,但读是正常的。

报错对照表

面板会把 Cloudflare 的错误码翻成人话,这里留一份底。

错误码含义怎么办
9109Token 没有这个接口的权限去 Token 权限里补上对应权限组
1000Token 无效检查是否复制完整、是否被吊销
7003路径或 ID 不存在确认 Zone ID 没抄错
81044记录已存在同类型同名称同内容不能重复
81057记录内容不合法检查 IP / 域名格式
81045TTL 不合法只能填 1(自动)或 60–86400
1416记录 ID 不存在记录可能已被删,刷新列表
1229请求太频繁等一分钟再来

记录类型速查

类型内容填什么备注
AIPv4 地址,如 192.0.2.1可开代理
AAAAIPv6 地址,如 2001:db8::1可开代理
CNAME目标域名,如 target.example.com可开代理,不能与 A 记录同名
MX邮件服务器域名需要填优先级(数字越小越优先)
TXT任意文本,SPF 验证都在这里含空格时 Cloudflare 会自动加引号
NS子域委派的名称服务器根域名的 NS 由 Cloudflare 管理,不可改
SRV目标主机,如 sip.example.com另外填优先级 / 权重 / 端口,名称形如 _sip._tcp
CAACA 域名,如 letsencrypt.org另外填 flags 与 tag(issue / issuewild)

名称栏填 @ 表示根域名,填 www 表示 www.你的域名,也可以直接写完整域名。

关于 Token 安全

请认真看
  • Token 保存在浏览器 localStorage,同域脚本都能读到 —— 别在公共电脑上用。
  • 服务端只在单次请求内使用 Token 转发,不写库、不写文件、不打日志。
  • 权限只勾需要的那几项;只读场景就把写权限降成 Read。
  • 怀疑泄露时,去 Cloudflare 后台 Roll 或 Delete 这个 Token,面板里点「清除」。

用起来快一点的几个地方

  • 搜一个就够:搜索框同时匹配名字和内容,输入 cdn 能把所有 CNAME 一次捞出来。
  • 按类型筛:记录页上面那排类型按钮是开关,点 MX 就只剩邮件记录,再点一下取消。
  • 批量删:表头左边的方框全选,底部会浮出一条操作栏,删之前会列清楚删哪几条。
  • 复制 Zone ID:域名卡和域名页都有这个按钮,粘到别处就能用,不用去 Cloudflare 后台翻。
  • 先试再动:导航栏的「示例数据」打开一份假域名,增删改都不会碰到真实记录,刷新即还原。
  • 想知道 Token 能干什么:域名页的「权限诊断」会把每个接口单独试一遍,绿的能用、红的缺权限。