SuperAPI AI 工具集

cloudflare-cli

部署与运维

查看项目

更新于 10-15 21:39

技能介绍

用途:Cloudflare CLI(命令名 cf,来自 coollabsio/cloudflare-cli)用于在终端管理 Cloudflare 的 DNS 记录与区域,支持脚本化操作。

主要能力:区域管理(cf zones list、cf zones get,接受区域名或区域 ID);DNS 记录 CRUD(cf dns list/get/create/update/delete/find);列表支持按类型、名称、内容搜索过滤;创建与更新支持 --ttl、--proxied、--priority、--comment 等参数;输出支持 table 与 json,可配合 jq 提取字段或记录 ID。

安装:Linux/macOS 可用官方安装脚本(curl -fsSL https://raw.githubusercontent.com/coollabsio/cloudflare-cli/main/scripts/install.sh | bash,加 --user 可免 sudo);也可 go install github.com/coollabsio/cloudflare-cli@latest,或克隆源码后 go build -o cf .;Windows 从 GitHub Releases 下载或 go build -o cf.exe .。

认证:在 Cloudflare 后台创建 API Token,需 Zone:Read、DNS:Read、DNS:Edit 权限。推荐 cf auth save <token> 保存到 ~/.cloudflare/config.yaml,并用 cf auth verify 验证;也支持环境变量 CLOUDFLARE_API_TOKEN 或 CF_API_TOKEN,以及旧版 API Key + Email。环境变量优先级高于配置文件。

配置与输出:cf config set/get/list 管理设置,output_format 可选 table 或 json;命令可用 --output json 或 -o json。

限制与注意事项:区域范围受限的 Token 无法执行 cf zones list 或把区域名解析为 ID,此时应直接使用区域 ID;Windows 上需先确保 ~/.cloudflare 目录存在;安装后若提示 cf: command not found,需检查 PATH。--proxied 仅适用于 A、AAAA、CNAME 记录。删除或更新前建议先用 cf dns find 或 cf dns get 确认记录 ID。命令名易混淆:二进制为 cf,区域列表为 cf zones list(复数),创建为 cf dns create,删除为 cf dns delete,认证为 cf auth save,区域作为位置参数传入。可用 cf update 自更新、cf version 查看版本。