PROVIDER - Cloudflare Workers 官方 CLI

Wrangler

Wrangler 是 Cloudflare Workers 官方 CLI,1 条命令发布到 300 多个边缘节点,本地可秒级启动并模拟运行时,支持 KV、D1、R2、Queues 等 6 种以上绑定,免费额度每日 10 万次请求;不足是 Node.js 兼容性有限、CPU 时间受限。

开发工具 美国 2026.11.19
4.1分

详细说明

优势 5 项

1 条 wrangler deploy 把代码发布到 300 多个边缘节点
本地开发服务器可在 1 秒级启动并模拟 Workers 运行时
支持 KV、D1、R2、Queues 等 6 种以上绑定资源类型
免费额度每日 10 万次请求,试验项目可 0 成本运行
内置 TypeScript 与主流框架模板,1 条命令生成项目骨架

不足 4 项

运行时基于 V8 Isolate,Node.js API 覆盖不完整
单请求 CPU 时间受限,重计算任务不适合
调试与日志能力相比本地 Node 环境仍有差距
平台绑定较强,迁移需重写绑定与运行时逻辑

服务商概述

Wrangler 是 Cloudflare Workers 的官方命令行工具,负责本地开发、构建、绑定管理与部署。

在开发工具分类里,它属于「边缘开发工具链」:把无服务器函数从本地调试一路带到全球边缘网络。

核心优势

  • 边缘节点多:300 多个位置
  • 本地模拟:秒级启动开发服务
  • 绑定类型全:6 种以上资源
  • 免费额度足:每日 10 万次请求
  • 模板齐全:TypeScript 与框架开箱

产品生态

平台能力

本地开发与热更新、wrangler.toml 配置管理、KV/D1/R2/Queues 绑定、环境与密钥管理、日志实时查看与多环境部署。

集成

与 Cloudflare 全家桶(Pages、R2、D1、Workers AI)联动,并可与 GitHub Actions 及主流前端框架构建流程集成。

典型场景

边缘 API 与网关、静态站动态能力、A/B 与重写规则、轻量数据库应用。

不足之处

  • 运行时限制:Node.js API 不完整
  • 计算限制:CPU 时间有上限
  • 调试体验:与本地 Node 有差距
  • 迁移成本:绑定与运行时需重写

适用场景

  • 边缘 API 开发(★★★★★):延迟优势明显
  • 轻量全栈应用(★★★★☆):D1 与 R2 组合可用
  • 重计算任务(★☆☆☆☆):不适合
  • 已有 Node 项目迁移(★★☆☆☆):需兼容改造

价格参考

项目 价格 备注
Free $0 每日 10 万次请求
Paid 按请求与 CPU 时间计费 含更高额度与日志能力
其他绑定服务 按用量计费 KV、R2、D1 单独计价

常见问题

与 Cloudflare Pages 的关系?

Wrangler 同时管理 Workers 与 Pages 的构建部署,Pages 更偏静态站。

支持 Node.js 模块吗?

提供 nodejs_compat 兼容层,但并非全部 API 可用。

本地能连真实资源吗?

可连接远程 KV、D1 等绑定做联调,也支持本地模拟。

有 TypeScript 模板吗?

有,wrangler init 可选择 TypeScript 与主流框架模板。

代码示例

# 安装并初始化项目
npm install -g wrangler
wrangler init demo-worker --ts

# 本地开发
wrangler dev

# 部署并查看实时日志
wrangler deploy
wrangler tail
# wrangler.toml
name = "demo-worker"
main = "src/index.ts"
compatibility_date = "2026-01-01"

[[kv_namespaces]]
binding = "CACHE"
id = "xxxxxxxxxxxxxxxx"

[[d1_databases]]
binding = "DB"
database_name = "demo"
database_id = "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"

社区与资源

  • 官方文档:https://developers.cloudflare.com/workers/
  • CLI 文档:https://developers.cloudflare.com/workers/wrangler/
  • 源码仓库:https://github.com/cloudflare/workers-sdk
前往 Wrangler 官网 → https://developers.cloudflare.com/workers/
访问官网 ↗