Cloudflare CLI（Wrangler）本地开发常用命令大全

Mr.Over2026/5/11大约 3 分钟

Cloudflare CLI（Wrangler）本地开发常用命令大全

Cloudflare 官方 CLI 工具：

Wrangler（当前主流）
用于开发：
- Workers
- Pages
- D1
- KV
- R2
- Durable Objects
- Hyperdrive
- 队列 Queue
- 部署与日志查看

官方文档：

一、安装 Wrangler

1. 使用 npm 安装

npm install -g wrangler

2. 查看版本

wrangler --version

二、登录 Cloudflare

登录账号

wrangler login

浏览器会自动打开授权页面。

三、创建项目

创建 Worker 项目

使用官方模板

npm create cloudflare@latest

创建后进入目录

cd my-project

四、本地开发

启动本地开发服务器

wrangler dev

默认：

本地地址：
http://localhost:8787

支持热更新。

指定端口

wrangler dev --port 3000

允许局域网访问

wrangler dev --ip 0.0.0.0

使用远程资源开发

有些资源（KV、D1、R2）希望直接连接线上：

wrangler dev --remote

本地环境变量

`.dev.vars`

JWT_SECRET=123456
API_KEY=test

运行：

wrangler dev

会自动读取。

五、部署

部署 Worker

wrangler deploy

指定环境部署

wrangler deploy --env production

删除 Worker

wrangler delete

六、日志查看

实时日志

wrangler tail

JSON格式日志

wrangler tail --format=json

七、D1 数据库常用命令

创建 D1 数据库

wrangler d1 create mydb

创建后会返回：

[[d1_databases]]
binding = "DB"
database_name = "mydb"
database_id = "xxxx"

复制到：

wrangler.toml

本地执行 SQL

创建表

wrangler d1 execute mydb --local --file=./schema.sql

线上执行 SQL

wrangler d1 execute mydb --remote --file=./schema.sql

直接执行 SQL

本地

wrangler d1 execute mydb --local --command="SELECT * FROM users"

线上

wrangler d1 execute mydb --remote --command="SELECT * FROM users"

查看数据库列表

wrangler d1 list

删除数据库

wrangler d1 delete mydb

导出数据库

wrangler d1 export mydb --output=backup.sql

八、KV 常用命令

创建 KV Namespace

wrangler kv namespace create mykv

写入 KV

wrangler kv key put mykey hello

读取 KV

wrangler kv key get mykey

删除 KV

wrangler kv key delete mykey

列出 KV Keys

wrangler kv key list

九、R2 常用命令

创建 Bucket

wrangler r2 bucket create mybucket

查看 Bucket

wrangler r2 bucket list

上传文件

wrangler r2 object put mybucket/test.txt --file ./test.txt

下载文件

wrangler r2 object get mybucket/test.txt --file ./download.txt

删除文件

wrangler r2 object delete mybucket/test.txt

十、Pages 常用命令

本地预览

wrangler pages dev ./dist

部署 Pages

wrangler pages deploy ./dist

创建 Pages 项目

wrangler pages project create my-pages

十一、Secret 环境变量

添加 Secret

wrangler secret put JWT_SECRET

输入后不会明文显示。

删除 Secret

wrangler secret delete JWT_SECRET

十二、查看配置

查看当前账号

wrangler whoami

查看帮助

wrangler --help

十三、TypeScript 类型生成

生成 Cloudflare 类型

wrangler types

十四、常见开发流程（推荐）

1. 创建项目

npm create cloudflare@latest

2. 安装依赖

npm install

3. 本地开发

wrangler dev

4. 创建 D1

wrangler d1 create mydb

5. 执行 SQL

wrangler d1 execute mydb --local --file=schema.sql

6. 部署

wrangler deploy

十五、Hono 项目常用命令

安装 Hono

npm install hono

安装 JWT

npm install hono jwt

安装 Zod

npm install zod

安装 drizzle

npm install drizzle-orm

十六、推荐目录结构

project/
├── src/
│   ├── api/
│   ├── middleware/
│   ├── services/
│   ├── utils/
│   ├── db/
│   └── index.ts
│
├── migrations/
├── schema.sql
├── wrangler.toml
├── package.json
└── tsconfig.json

十七、wrangler.toml 示例

name = "my-worker"
main = "src/index.ts"
compatibility_date = "2026-05-11"

[[d1_databases]]
binding = "DB"
database_name = "mydb"
database_id = "xxxx"

[[kv_namespaces]]
binding = "KV"
id = "xxxx"

[[r2_buckets]]
binding = "R2"
bucket_name = "mybucket"