Wrangler 是 Cloudflare Workers 的官方 CLI,用于命令行方式开发、部署和管理 Workers。资料强调:其 CLI 标志、配置字段和子命令可能已过时,应优先检索官方文档、本地 config-schema.json 与 Cloudflare 文档,而非依赖预训练知识。
主要用途与能力:初始化与部署 Worker(wrangler init、wrangler deploy)、本地开发(wrangler dev)、生成 TypeScript 类型(wrangler types)、查看日志(wrangler tail)、管理密钥(wrangler secret)、版本与回滚(wrangler versions、wrangler rollback),以及管理 KV、R2、D1、Vectorize、Hyperdrive、Workers AI、Queues、Containers、Workflows、Pipelines、Secrets Store、Pages 等资源。
使用方式:先确认是否安装,运行 wrangler --version 需 v4.x+;未安装则执行 npm install -D wrangler@latest。配置推荐使用 wrangler.jsonc,设置较新的 compatibility_date,并在配置变更后运行 wrangler types。尽量使用 Wrangler 而非手工构造 API 请求。
限制与安全要点:本地开发默认使用本地存储模拟,除非设置 remote: true;Workers AI 始终远程运行并产生费用。不要把密钥值作为命令参数或通过 echo 管道传递,应使用交互式提示、从文件读取或 bulk 方式,且不要输出、记录或硬编码密钥。
资料未提供具体收费标准、平台可用性或完整命令列表之外的内容;部分功能细节需以官方最新文档为准。