SuperAPI AI 工具集

cloudflare-dns

部署与运维

查看项目

更新于 10-16 09:32

技能介绍

用途:配置与排查 Cloudflare DNS 记录,以及 Cloudflare Pages 自定义域名绑定。适用于用户要求新增、编辑、删除 DNS 记录,或把自定义域名映射到 Pages 项目的场景。

主要能力:先明确目标(域名/主机名、记录类型 A/AAAA/CNAME/TXT、目标值、是否开启代理),在任何写入前执行鉴权预检;采用幂等变更(先查询现有记录,再创建或更新);完成后用 DNS 查询、HTTP 检查以及必要的 Pages 域名状态进行验证。

使用方式:首次写入前检查令牌,命令为 zsh -lic 'echo ${CLOUDFLARE_API_TOKEN:+SET}',为空则停止并提示用户先配置。所需最小权限为 Zone -> DNS -> Edit、Zone -> Zone -> Read;若需查询 Pages 域名状态,再加 Account -> Cloudflare Pages -> Edit,Zone Resources 只选目标域名。配置后执行 export CLOUDFLARE_API_TOKEN='YOUR_TOKEN',可选持久化写入 ~/.zshrc 并 source。标准流程:读取当前 DNS 记录、创建或更新记录(已正确则报告 no-op)、按需绑定 Pages 自定义域名、最后验证,例如 dig +short CNAME skills.01mvp.com、dig +short skills.01mvp.com、curl -I https://skills.01mvp.com。

限制与安全规则:始终先查询再写入,避免盲目覆盖;使用最小权限令牌;不得在输出中打印完整令牌;报告变更的准确记录(名称、类型、内容、代理状态、时间戳);若 API 返回鉴权错误,应明确告知用户缺少的权限范围,而非盲目重试。其他细节暂未提供。