全部文档

命令行（rrangler）

用兼容 wrangler 的 rrangler 命令行，在终端里部署和管理一切。

rrangler（同时安装为 rr）是 RandallFlare 的命令行工具，命令和配置文件与 Cloudflare 的 wrangler 相同。现有的 Workers 项目通常不用改就能部署。

安装并登录

bash

npm i -g @bigrandall/rrangler   # 需要 Node 20 或更新版本
rr --version
rr login --token rfp_…         # 保存在 ~/.rrangler.json
rr whoami
rr doctor                      # 查看令牌能做哪些事

令牌在 API 令牌里创建。也可以每条命令用 --token 或环境变量 RRANGLER_TOKEN 传入。

第一次部署

bash

rr init hello            # --ts 用 TypeScript，--python 用 Python
cd hello
rr dev                   # 在本地 :8787 运行，与边缘使用同一运行时
rr deploy                # 打包，按需创建应用，然后发布
rr versions list
rr rollback              # 回到上一个版本

jsonc

{
  "name": "my-app",
  "main": "src/index.ts",
  "compatibility_date": "2026-09-22",
  "vars": { "GREETING": "hello" },
  "kv_namespaces": [{ "binding": "CACHE", "title": "my-cache" }],
  "d1_databases": [{ "binding": "DB", "database_name": "my-db" }],
  "r2_buckets": [{ "binding": "FILES", "bucket_name": "my-files" }],
  "queues": { "producers": [{ "binding": "JOBS", "queue": "jobs" }] },
  "triggers": { "crons": ["*/5 * * * *"] },
  "assets": { "directory": "./public" },
  "env": { "staging": { "vars": { "GREETING": "hi" } } }
}

命令	作用
`rr deploy` / `rr dev`	发布，或在本地运行（模拟 KV、D1 和 R2）
`rr tail [app]`	实时查看日志
`rr secret put\|list\|delete`	管理密钥
`rr domains add <host>`	绑定自定义域名，并打印需要创建的 DNS 记录
`rr versions list\|deploy <n>` / `rr rollback`	查看和切换版本
`rr d1 execute DB --command "…"`	执行 SQL；`rr d1 migrations apply DB` 应用迁移
`rr kv key put\|get\|list`	读写键
`rr r2 object put\|get\|list`	上传和下载文件
`rr queues send <q> '<json>'`	发送一条消息
`rr workflows trigger <name> --params '<json>'`	启动一次 workflow 运行
`rr cdn …`、`rr dns …`、`rr waf …`	网站加速、DNS 和防火墙
`rr api GET /compute`	直接调用任意 API 接口

命令行（rrangler）

安装并登录

第一次部署

配置文件

常用命令

与 wrangler 的区别