归档日期：2026-09-29
核心组件：CloudflarecfCLI (v1.0.0-beta.5) + Cloudflare 官方 Agent 技能生态矩阵
适用环境：Windows 11 / WSL2 / 智能体终端（Antigravity, Claude Code, Cursor）
目录
- 一、 战略升级：为什么是 cf CLI 而不是传统 Wrangler？
- 二、 本机安装与运行环境
- 三、 Agentic Native：专为智能体打造的核心交互机制
- 四、 本地智能体专属技能库（Agent Skills）配置
- 五、 常用高频指令速查大纲
- 六、 避坑与排错指南
一、 战略升级：为什么是 cf CLI 而不是传统 Wrangler？
在过去，开发者主要使用 wrangler 部署 Workers 与 Pages。但随着 Cloudflare 生态从“边缘 Serverless 函数”扩展至涵盖 D1（数据库）、R2（存储）、Zero Trust、Containers、Email Routing、AI Gateway 的全栈云平台，传统的 wrangler 在多产品管理上显得割裂。
2026 年 Cloudflare 官方重磅推出统一 CLI —— cf：
- 统一控制中枢：单命令接管 Cloudflare 全线产品（计算、存储、网络、安全、域名、AI）。
- Agent-First（智能体原生优先）：内置针对 LLM / Coding Agent 的自省能力（Self-discovery），智能体可自行探索 API、查询 Schema、无需人类手写长命令。
- 架构平滑演进：传统 Workers 开发仍可与
wrangler互通，但宏观资源编排推荐全面接入cf。
二、 本机安装与运行环境
1. 全局安装
通过 Node.js 全局包管理器安装：
npm install -g cf2. 本机部署路径验证
- 版本号：
cf · v1.0.0-beta.5 - 执行命令路径：
C:\Users\<User>\AppData\Roaming\npm\cf.cmd - 全局模块路径：
C:\Users\<User>\AppData\Roaming\npm\node_modules\cf
3. 基础健康检查
# 验证安装版本
cf --version
# 查看支持的一级子系统
cf --help三、 Agentic Native：专为智能体打造的核心交互机制
cf CLI 最革命性的特性在于其为 AI Agent 设计的内省命令，智能体即使不知道某个新特性的具体参数，也能自愈发现：
1. 动态能力搜索 (cf cli search)
Agent 可以用自然语言查询 Cloudflare 开放平台命令：
cf cli search "create D1 database and bind to worker"终端会输出精确的子命令与参数规范。
2. 结构化 Schema 导出 (cf schema)
为大模型的 Tool Call / Function Calling 输出标准 JSON Schema，杜绝参数幻觉：
cf schema workers deploy四、 本地智能体专属技能库（Agent Skills）配置
已将 Cloudflare 官方全套技能同步部署至全局技能库：
| 技能名称 | 功能职责 | 适用场景 |
|---|---|---|
cloudflare-cf-cli | 统一管理 cf 命令行体系、Schema 探测与自动化调用 | 涉及 Cloudflare 全生态综合运维 |
cloudflare | 产品选型与整体架构设计导航 | 面对新需求时挑选免费层级最优组合 |
wrangler | 专注 Workers / Pages 代码构建与本地调试 | 传统项目的开发热重载与预览 |
nextjs-on-cloudflare | Next.js 项目通过 vinext 部署至 Workers | 现代 React 全栈框架迁移与上线 |
durable-objects | 分布式强一致性状态机管理 | 协同编辑、Websocket、持久化智能体开发 |
cloudflare-one | Zero Trust、安全网关与 Tunnel 自动化 | 私有服务免公网 IP 穿透与鉴权 |
cloudflare-one-migrations | 传统 VPN 迁移至 Cloudflare Zero Trust | 企业/个人混合云安全访问重构 |
cloudflare-email-service | 域名邮件路由转发与无服务器发信 | 接收验证码、通知类邮件触发器 |
workers-best-practices | 官方生产级代码规范与安全审计 | 上线前边缘函数性能排查与合规审查 |
五、 常用高频指令速查大纲
# 1. 账号与认证
cf auth login
cf auth whoami
# 2. 边缘函数 (Workers)
cf workers list
cf workers tail <worker-name> # 实时日志抓取
# 3. 关系型数据库 (D1)
cf d1 list
cf d1 execute <db-name> --command "SELECT * FROM users LIMIT 5;"
# 4. 对象存储 (R2)
cf r2 bucket list
cf r2 object put <bucket-name>/file.png --file ./file.png
# 5. 内网穿透 (Tunnel)
cf tunnel list
cf tunnel run <tunnel-name>六、 避坑与排错指南
- 终端字符编码与乱码问题：
在 Windows PowerShell 下使用cf时，输出可能包含 UTF-8 符号。如果终端出现乱码，需确保执行了：[Console]::OutputEncoding = [System.Text.Encoding]::UTF8 - 多账号切换：
在跨个人/企业项目时，推荐通过环境变量CLOUDFLARE_API_TOKEN或命名配置文件隔离鉴权，避免全局 Token 串号。 - CI/CD 环境构建隔离：
在自动化流水线中，推荐将cf安装在本地项目开发依赖或通过npx cf按需调用，确保构建节点版本严格锁死。