使用说明
三步配好 Token,再附一份报错对照表和记录类型速查。
2
勾对权限
按下面那张表勾。少勾 Zone:Read,域名列表就会是空的 —— 这是最常见的坑。
3
粘进设置页
点「保存并验证」,看到四项检查全绿就可以回总览页刷域名了。
权限清单
Custom Token 里逐条添加,Account Resources / Zone Resources 都选你要管的范围。
| 权限组 | 级别 | 为什么需要 |
|---|---|---|
| Zone → Zone | Read | 读域名列表与域名详情。缺了它 /zones 返回空数组。 |
| Zone → DNS | Edit | 解析记录的增删改查。 |
| Zone → Cache Purge | Purge | 清理边缘缓存。 |
| Zone → Zone Settings | Edit | 改 SSL、Always Use HTTPS、开发模式等开关。 |
| Account → Account Settings | Read | 可选。读账户信息与 DNS 设置,诊断更准。 |
只想看不想改?把 DNS 和 Zone Settings 的级别降成 Read,页面上的写操作按钮会报 9109,但读是正常的。
报错对照表
面板会把 Cloudflare 的错误码翻成人话,这里留一份底。
| 错误码 | 含义 | 怎么办 |
|---|---|---|
| 9109 | Token 没有这个接口的权限 | 去 Token 权限里补上对应权限组 |
| 1000 | Token 无效 | 检查是否复制完整、是否被吊销 |
| 7003 | 路径或 ID 不存在 | 确认 Zone ID 没抄错 |
| 81044 | 记录已存在 | 同类型同名称同内容不能重复 |
| 81057 | 记录内容不合法 | 检查 IP / 域名格式 |
| 81045 | TTL 不合法 | 只能填 1(自动)或 60–86400 |
| 1416 | 记录 ID 不存在 | 记录可能已被删,刷新列表 |
| 1229 | 请求太频繁 | 等一分钟再来 |
记录类型速查
| 类型 | 内容填什么 | 备注 |
|---|---|---|
| A | IPv4 地址,如 192.0.2.1 | 可开代理 |
| AAAA | IPv6 地址,如 2001:db8::1 | 可开代理 |
| CNAME | 目标域名,如 target.example.com | 可开代理,不能与 A 记录同名 |
| MX | 邮件服务器域名 | 需要填优先级(数字越小越优先) |
| TXT | 任意文本,SPF 验证都在这里 | 含空格时 Cloudflare 会自动加引号 |
| NS | 子域委派的名称服务器 | 根域名的 NS 由 Cloudflare 管理,不可改 |
| SRV | 目标主机,如 sip.example.com | 另外填优先级 / 权重 / 端口,名称形如 _sip._tcp |
| CAA | CA 域名,如 letsencrypt.org | 另外填 flags 与 tag(issue / issuewild) |
名称栏填 @ 表示根域名,填 www 表示 www.你的域名,也可以直接写完整域名。
关于 Token 安全
请认真看- Token 保存在浏览器 localStorage,同域脚本都能读到 —— 别在公共电脑上用。
- 服务端只在单次请求内使用 Token 转发,不写库、不写文件、不打日志。
- 权限只勾需要的那几项;只读场景就把写权限降成 Read。
- 怀疑泄露时,去 Cloudflare 后台 Roll 或 Delete 这个 Token,面板里点「清除」。
用起来快一点的几个地方
- 搜一个就够:搜索框同时匹配名字和内容,输入 cdn 能把所有 CNAME 一次捞出来。
- 按类型筛:记录页上面那排类型按钮是开关,点 MX 就只剩邮件记录,再点一下取消。
- 批量删:表头左边的方框全选,底部会浮出一条操作栏,删之前会列清楚删哪几条。
- 复制 Zone ID:域名卡和域名页都有这个按钮,粘到别处就能用,不用去 Cloudflare 后台翻。
- 先试再动:导航栏的「示例数据」打开一份假域名,增删改都不会碰到真实记录,刷新即还原。
- 想知道 Token 能干什么:域名页的「权限诊断」会把每个接口单独试一遍,绿的能用、红的缺权限。