Tunnel

直接从 Wrangler 管理 Cloudflare Tunnels。创建、运行和管理隧道，将本地服务安全连接到 Cloudflare 网络——无需公网 IP。

Wrangler 会自动管理 cloudflared 二进制文件。首次使用时，Wrangler 会提示你将 cloudflared 下载到本地缓存目录。你可以通过自行安装 cloudflared 并将其添加到 PATH，或设置 CLOUDFLARED_PATH 环境变量指向现有二进制文件来跳过此步骤。

创建新的远程托管 Cloudflare Tunnel。

wrangler tunnel create <NAME>

• NAME stringrequired
  • tunnel 的名称。在你的账户内必须唯一。

通过 Wrangler 创建的 tunnel 始终为远程托管 — 在 Cloudflare 仪表板 ↗或通过 API 进行配置。

创建后，使用 tunnel ID 运行 wrangler tunnel run 以启动 tunnel。

npx wrangler tunnel create my-app

Creating tunnel "my-app"
Created tunnel.
ID: f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
Name: my-app

To run this tunnel, configure its ingress rules in the Cloudflare dashboard, then run:
   wrangler tunnel run f70ff985-a4ef-4643-bbbc-4a0ed4fc8415

以下全局标志适用于每个命令：

• --help boolean
  • 显示帮助。
• --config string（Pages 不支持）
  • 指向你的 Wrangler 配置文件的路径。
• --cwd string
  • 在指定目录中运行，而不是当前工作目录。

从账户中删除 Cloudflare Tunnel。

wrangler tunnel delete <TUNNEL> [OPTIONS]

• TUNNEL stringrequired
  • 要删除的 tunnel 的名称或 UUID。
• --force booleanoptional
  • 跳过确认提示。

npx wrangler tunnel delete f70ff985-a4ef-4643-bbbc-4a0ed4fc8415

Are you sure you want to delete tunnel "f70ff985-a4ef-4643-bbbc-4a0ed4fc8415"? This action cannot be undone. (y/n)
Deleting tunnel f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
Tunnel deleted.

以下全局标志适用于每个命令：

• --help boolean
  • 显示帮助。
• --config string（Pages 不支持）
  • 指向你的 Wrangler 配置文件的路径。
• --cwd string
  • 在指定目录中运行，而不是当前工作目录。

显示 Cloudflare Tunnel 的详细信息，包括 ID、名称、状态和创建时间。

wrangler tunnel info <TUNNEL>

• TUNNEL stringrequired
  • 要检查的 tunnel 的名称或 UUID。

npx wrangler tunnel info f70ff985-a4ef-4643-bbbc-4a0ed4fc8415

Getting tunnel details
ID: f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
Name: my-app
Status: healthy
Created: 2025-01-15T10:30:00Z
Type: cfd_tunnel

以下全局标志适用于每个命令：

• --help boolean
  • 显示帮助。
• --config string（Pages 不支持）
  • 指向你的 Wrangler 配置文件的路径。
• --cwd string
  • 在指定目录中运行，而不是当前工作目录。

列出账户中的所有 Cloudflare Tunnel。

wrangler tunnel list

输出包括每个 tunnel 的 ID、名称、状态和创建日期。仅显示未删除的 tunnel。

npx wrangler tunnel list

Listing Cloudflare Tunnels

ID                                   Name       Status    Created
f70ff985-a4ef-4643-bbbc-4a0ed4fc8415 my-app     healthy   2025-01-15T10:30:00Z
550e8400-e29b-41d4-a716-446655440000 api-tunnel inactive  2025-01-10T15:45:00Z

以下全局标志适用于每个命令：

• --help boolean
  • 显示帮助。
• --config string（Pages 不支持）
  • 指向你的 Wrangler 配置文件的路径。
• --cwd string
  • 在指定目录中运行，而不是当前工作目录。

使用 cloudflared 守护进程运行 Cloudflare Tunnel。这会在本地计算机与 Cloudflare 网络之间建立持久连接。

wrangler tunnel run [TUNNEL] [OPTIONS]

• TUNNEL stringoptional
  • 要运行的 tunnel 的名称或 UUID。除非提供了 --token，否则为必填项。
• --token stringoptional
  • 直接使用的 tunnel 令牌。跳过 API 身份验证。
• --log-level string(default: info) optional
  • cloudflared 的日志级别。不影响 Wrangler 日志（由 WRANGLER_LOG 控制）。可选值：debug、info、warn、error、fatal。

命名 tunnel 为远程托管 — 在运行 tunnel 之前，在 Cloudflare 仪表板 ↗或通过 API 配置 ingress 规则（要暴露的本地服务）。

有两种运行 tunnel 的方式：

按 tunnel 名称或 ID（通过 API 获取令牌）：

npx wrangler tunnel run my-app

按令牌（无需 API 身份验证 — 适用于 CI/CD 或远程服务器）：

npx wrangler tunnel run --token eyJhIjoiNGE2MjY...

按 Ctrl+C 停止 tunnel。Wrangler 在退出前会向 cloudflared 发送优雅关闭信号。

以下全局标志适用于每个命令：

• --help boolean
  • 显示帮助。
• --config string（Pages 不支持）
  • 指向你的 Wrangler 配置文件的路径。
• --cwd string
  • 在指定目录中运行，而不是当前工作目录。

使用 Quick Tunnels 在没有 Cloudflare 账户的情况下启动免费的临时 tunnel。适用于快速演示、测试 webhook 或共享本地开发服务器。

wrangler tunnel quick-start <URL>

• URL stringrequired
  • 要暴露的本地 URL（例如 http://localhost:8080）。

tunnel 会被分配一个随机的 *.trycloudflare.com 子域名，并在进程运行期间保持有效。

npx wrangler tunnel quick-start http://localhost:8080

Starting quick tunnel to http://localhost:8080...
Your tunnel URL: https://random-words-here.trycloudflare.com

以下全局标志适用于每个命令：

• --help boolean
  • 显示帮助。
• --config string（Pages 不支持）
  • 指向你的 Wrangler 配置文件的路径。
• --cwd string
  • 在指定目录中运行，而不是当前工作目录。