---
title: "Cloudflare Workers 官方 Wrangler CLI命令"
slug: "wrangler-cli"
date: "2026-10-07 17:56"
updated: "2026-10-07T18:20:57+08:00"
category: "笔记"
description: "进入web目录(如果不存在请先创建) cd E:\\web\\room 全局安装(推荐) npm install -g wrangler 或 npx临时运行 npx wrangler \\# 登录 Cloudflare 账号 wrangler login \\# 验证登录状态 npx wrangler whoami \\# 交互…"
url: https://blog.dayuai.com/wrangler-cli
---
-  进入web目录(如果不存在请先创建) `cd E:\web\room`


全局安装(推荐) `npm install -g wrangler`


或 npx临时运行 `npx wrangler <command>`


\# 登录 Cloudflare 账号 `wrangler login`


\# 验证登录状态 `npx wrangler whoami`


\# 交互式创建新项目 `npx wrangler init my-worke_rname`


\# 使用模板创建
npx w`rangler init my-worker --type webpack   `npx w`rangler init my-worker --type typescript`


\# 在已有目录初始化
`cd existing-project   `npx w`rangler init`


\# 本地开发服务器(默认端口 8787) `wrangler dev`


\# 指定端口 `npx wrangler dev --port 3000`


\# 远程模式调试(连接真实 Cloudflare 环境) `npx wrangler dev --remote`


\# 查看实时日志 `npx wrangler tail --format json`


- 发布到生产环境 `npx wrangler deploy`


\# 发布指定文件 `npx wrangler deploy src/index.js`


\# 发布到预览环境(不影响生产) `npx wrangler deploy --env staging`


\# 指定 wrangler 配置文件 `npx wrangler deploy --config wrangler.custom.toml`


\# 干跑模式(不实际发布,只检查) `npx wrangler deploy --dry-run`


\# 设置普通环境变量 `npx wrangler secret put MY_KEY`


\# 列出所有 secrets : `npx wrangler secret list`


\# 删除 secret: `npx wrangler secret delete MY_KEY`


\# 通过命令行添加路由


`npx wrangler route add "api.example.com/*" <script-name>   npx wrangler route list   npx wrangler route delete <route-id>`