SuperAPI AI 工具集

wrangler

部署与运维

查看项目

更新于 10-16 08:36

技能介绍

用途:Wrangler 是 Cloudflare 的命令行工具,用于开发、部署和管理 Cloudflare Workers、Pages、R2、D1、KV 等边缘资源。资料标注版本为 4.59.2+(2026 年 1 月),推荐使用 wrangler.jsonc 而非 .toml 作为配置格式。

主要能力:本地开发(wrangler dev)、部署(wrangler deploy)、查看日志(wrangler tail)、管理密钥(wrangler secret put/list)、生成类型(wrangler types)、检查配置(wrangler check startup)。支持 D1 数据库(wrangler d1 create/execute)、R2 存储(wrangler r2 bucket/object 操作)以及 KV 命名空间。v4.57+ 支持自动预配:在配置中只写 binding 而不填 id、bucket_name 或 database_id,部署时会自动创建对应资源。

使用方式:新建项目用 npx create-cloudflare@latest my-worker;本地开发用 wrangler dev;部署用 wrangler deploy;日志用 wrangler tail。密钥通过 wrangler secret put NAME 添加,不要写入配置文件。多环境可在配置的 env 段定义 staging、production,再用 wrangler deploy --env staging 部署。CI/CD 可用 CLOUDFLARE_API_TOKEN 和 CLOUDFLARE_ACCOUNT_ID 环境变量认证。

适用场景:Cloudflare Workers 与 Pages 的边缘部署、R2/D1/KV 资源管理、定时任务(在配置中添加 triggers)、多环境发布。

限制与注意事项:仪表盘上的改动可能被覆盖,需加 "keep_vars": true 保留;密钥不应放入配置;配置变更后需重新运行 wrangler types;compatibility_date 建议每年更新。资料还提到 --x-provision、--x-auto-create、--x-autoconfig 等隐藏/实验性标志。具体收费、价格与平台细节暂未提供。