SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场pp-cloudflare

pp-cloudflare

部署与运维

查看项目

更新于 10-15 12:10

技能介绍

用途

pp-cloudflare 是 Cloudflare 的 Printing Press CLI 技能，驱动 cloudflare-pp-cli 二进制文件。它用于从终端对 Cloudflare 进行「智能体安全」的访问，覆盖账户、区域（zones）、DNS、Workers、Pages、R2、Email Routing、隧道、Zero Trust、Radar、令牌诊断以及部署工作流。

该 CLI 最适合处理在仪表盘中操作起来较为繁琐的复合型 Cloudflare 工作，例如：在任务开始前检查令牌权限；将域名接入 Pages 或 Workers；诊断 DNS/SSL/Email Routing 的就绪状态；以脱敏输出管理 Worker 密钥；扫描成本与用量信号；或为智能体基础设施引导 R2/D1/KV/Queues/Vectorize/AI Gateway 资源。

前置条件与安装

必须先验证 CLI 已安装，然后才能调用本技能中的任何命令。若缺失，请先安装。

通过 Printing Press 安装器安装（macOS/Linux 默认二进制目录为 $HOME/.local/bin，Windows 为 %LOCALAPPDATA%\Programs\PrintingPress\bin）：

npx -y @mvanhorn/printing-press-library install cloudflare --cli-only

验证：

cloudflare-pp-cli --version

请确保报告出的安装目录位于将要调用本技能的智能体/运行时的 $PATH 中。

若 npx 安装失败（无 Node、离线等），可回退到直接使用 Go 安装（需要 Go 1.26.6 或更高版本）。该方式会安装到 $GOPATH/bin（默认 $HOME/go/bin），因此需将该目录加入 $PATH：

go install github.com/mvanhorn/printing-press-library/library/cloud/cloudflare/cmd/cloudflare-pp-cli@latest

若安装后 --version 报告「command not found」，说明运行时无法在 $PATH 中看到该二进制目录。在验证成功之前，请勿继续执行本技能的命令。

认证方式

认证以令牌优先。推荐在 CLOUDFLARE_API_TOKEN 中使用作用域受限的 API 令牌，或通过 cloudflare-pp-cli auth set-token 设置；除非某个旧版端点要求，否则应避免使用全局 API 密钥。在执行实际变更操作之前，先使用令牌医生（token doctor）与配方（recipe）命令，以便智能体能够请求最小可行的权限。

主要命令

  • accounts — 管理账户：创建、删除、查看详情、列表、更新；批量移动账户集合到指定组织（标注为未实现）。创建/删除仅对租户管理员开放。
  • certificates — 管理证书：创建、获取、列出、吊销 Origin CA 证书。
  • internal — 内部路由，用于测试 URL 提交。
  • ips — 获取 Cloudflare/JD Cloud 网络上使用的 IP。
  • live — 运行存活检查后返回成功消息。
  • memberships — 管理成员资格：移除账户成员、获取特定成员资格、列出用户可访问账户的成员资格、接受或拒绝账户邀请。
  • oauth — 列出所有可用的 OAuth 作用域（需要认证但无授权角色要求）。
  • organizations — 管理组织：为用户创建组织、删除组织（删除前组织必须为空）、列出用户可访问的组织、修改组织、获取组织详情。组织功能目前处于公开测试阶段。
  • radar — 管理 Radar 数据，命令数量最多，涵盖：AI 智能体就绪度与 AI 机器人流量统计、Workers AI 推理统计、面向智能体的 Markdown 缩减比、网络中断与异常注解、自治系统（AS）与 Botnet 威胁源、三层/七层攻击的汇总与时间序列与 Top 排行、BGP 劫持与路由泄漏事件、BGP IP 空间时间序列与 Top AS、前缀到 ASN 映射、MOAS 前缀、路由表统计与实时路由、RPKI ASPA/ROA 相关变化与快照、机器人详情与列表等。

（命令清单中部分条目在原始资料中未完整给出，例如 radar 的部分子命令在此处被截断。）

适用场景

  • 需要在终端以脚本化、智能体友好的方式批量操作 Cloudflare 资源时。
  • 需要在执行变更前核对令牌权限范围时。
  • 需要诊断域名在 DNS、SSL、邮件路由方面的配置就绪度时。
  • 需要以脱敏方式管理 Worker 密钥时。
  • 需要监控成本与用量信号时。
  • 需要为智能体基础设施预置存储与计算资源（R2/D1/KV/Queues/Vectorize/AI Gateway）时。

限制

  • 必须先安装 cloudflare-pp-cli 并确保其安装目录在 $PATH 中，验证失败时不得继续。
  • accounts 的批量移动命令在资料中标注为「未实现」。
  • 账户创建与删除当前仅对租户管理员开放。
  • organizations 相关功能处于公开测试阶段，删除前组织必须为空。
  • 认证建议使用作用域受限的 API 令牌，避免全局 API 密钥（除非旧版端点要求）。
  • Radar 部分端点已被弃用（例如按行业/垂直领域的 Top 排行，需改用对应的 summary 端点）。
  • 关于收费、价格、平台支持范围与具体效果，原始资料暂未提供。