Cloudflare CLI 一般指的是 wrangler，这是 Cloudflare 官方提供的命令行工具，用来管理和开发 Cloudflare 平台上的各种服务，尤其是 Cloudflare Workers。
一、Cloudflare CLI 是什么？
Wrangler 是 Cloudflare 的官方 CLI（Command Line Interface），主要用于：
- 开发、测试、部署 Cloudflare Workers
- 管理 Pages、R2、KV、D1、Queues、Durable Objects
- 与 Cloudflare 账号和项目进行交互
一句话概括：
Wrangler = Cloudflare 平台的开发与运维入口
二、能做什么？（核心功能）
1️⃣ Workers（最常用）
- 创建 Workers 项目
- 本地开发与调试
- 一键部署到全球边缘节点
wrangler init my-worker
wrangler dev
wrangler deploy
2️⃣ Cloudflare Pages
用于前端项目（如 React / Vue / Next.js）部署：
wrangler pages dev
wrangler pages deploy
3️⃣ KV（键值存储）
适合缓存、配置、小数据存储：
wrangler kv:namespace create my_kv
wrangler kv:key put --binding=MY_KV hello world
4️⃣ R2（对象存储，类似 S3）
- 存文件、图片、备份
- 无出口流量费
wrangler r2 bucket create my-bucket
wrangler r2 object put my-bucket/file.txt ./file.txt
5️⃣ D1（Serverless SQLite）
- Cloudflare 的托管 SQLite 数据库
- 非常适合轻量后端
wrangler d1 create my-db
wrangler d1 execute my-db --command "SELECT 1"
6️⃣ Durable Objects
- 有状态服务
- 适合聊天室、协作应用、游戏房间
Wrangler 用于创建、绑定和迁移 Durable Objects。
三、安装方式
前置条件
- Node.js ≥ 16（推荐 LTS）
安装
npm install -g wrangler
或使用 pnpm / yarn：
pnpm add -g wrangler
yarn global add wrangler
验证：
wrangler --version
四、登录与配置
wrangler login
会自动打开浏览器完成 OAuth 授权。
项目核心配置文件是：
wrangler.toml
示例：
name = "my-worker"
main = "src/index.ts"
compatibility_date = "2024-01-01"
[[kv_namespaces]]
binding = "MY_KV"
id = "xxxxxxxx"
五、适合哪些人用？
非常适合：
- 🧑💻 前端工程师（想要 Serverless 后端）
- 🚀 想要低延迟全球部署的应用
- 💸 希望减少服务器运维成本
- 🌍 Edge Computing 场景
不太适合：
- 重度计算
- 大型关系型数据库
- 长时间运行任务（Workers 有执行时间限制）
六、Wrangler vs 传统后端
| 对比项 | Wrangler / Workers | 传统服务器 |
|---|---|---|
| 部署 | 秒级 | 分钟～小时 |
| 运维 | 几乎没有 | 需要 |
| 扩展 | 自动 | 手动 |
| 成本 | 按量 | 固定 |
七、常见使用场景
- API 网关 / BFF
- 边缘鉴权
- 图片处理
- Webhook 接收
- 轻量 SaaS 后端
- AI API 中转（OpenAI、Claude 等）