SuperAPI AI 工具集

cloudflare

部署与运维

查看项目

更新于 10-16 02:36

技能介绍

用途:通过 Cloudflare REST API 管理 DNS 与 Zone,并访问 CDN 缓存、防火墙、分析及账户级资源。适用于用户提到 Cloudflare、DNS 记录、Zone 或 CDN 设置时的自动化操作。

主要能力:验证 Token;列出与查看 Zone 详情;列出、创建、更新、删除 DNS 记录;列出 Workers 脚本、KV 命名空间、R2 存储桶;清除 Zone 缓存;列出防火墙规则;获取 Zone 分析数据。

使用方式:所有请求基址为 https://api.cloudflare.com/client/v4,认证头为 Authorization: Bearer $CLOUDFLARE_TOKEN。常用命令示例:验证 Token 用 curl -s "https://api.cloudflare.com/client/v4/user/tokens/verify" --header "Authorization: Bearer $CLOUDFLARE_TOKEN" | jq .;列出 Zone 用 curl -s "https://api.cloudflare.com/client/v4/zones" --header "Authorization: Bearer $CLOUDFLARE_TOKEN" | jq .;列出 DNS 记录用 curl -s "https://api.cloudflare.com/client/v4/zones/$CLOUDFLARE_ZONE_ID/dns_records" --header "Authorization: Bearer $CLOUDFLARE_TOKEN" | jq .。创建或更新记录时先将 JSON 写入 /tmp/cloudflare_request.json,再以 POST 或 PUT 发送,例如 curl -s -X POST "https://api.cloudflare.com/client/v4/zones/$CLOUDFLARE_ZONE_ID/dns_records" --header "Authorization: Bearer $CLOUDFLARE_TOKEN" --header "Content-Type: application/json" -d @/tmp/cloudflare_request.json | jq .。删除记录用 DELETE 同一路径加 RECORD_ID。清除缓存向 /zones/$CLOUDFLARE_ZONE_ID/purge_cache 发送 {"purge_everything": true}。账户级资源需使用 $CLOUDFLARE_ACCOUNT_ID。

常见 DNS 记录类型:A(IPv4)、AAAA(IPv6)、CNAME(别名)、MX(邮件服务器,含优先级)、TXT(SPF、DKIM 等)、NS(名称服务器)、SRV(服务定位)。

限制与注意事项:推荐使用 API Token 而非 Global API Key,以获得最小权限;列表接口分页,默认每页 20-100 条,可用 page 与 per_page 参数遍历;响应含 success、errors、messages、result 字段,使用 result 前先检查 success;proxied: true 会经 Cloudflare CDN 并启用安全功能,并非所有记录类型支持代理;多数端点需 32 位十六进制 Zone ID 而非域名;Workers、R2、KV 等需 Account ID;API 有速率限制,遇 429 应实现退避。故障排查可运行 zero doctor check-connector --env-name CLOUDFLARE_TOKEN 或 zero doctor check-connector --url https://api.cloudflare.com/client/v4/user/tokens/verify --method GET。