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 等）

---