tunnel-manager

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Tunnel Manager

隧道管理器

Agnostic tunnel management supporting Cloudflare, Tailscale, and other providers. Create, manage, and monitor tunnels with a unified interface.

支持Cloudflare、Tailscale及其他服务商的通用隧道管理工具，通过统一界面创建、管理和监控隧道。

Setup

安装配置

Requires tunnel provider CLI tools installed:

Cloudflare Tunnel:
```
cloudflared
```
Tailscale:
```
tailscale
```

需要安装隧道服务商的CLI工具：

Cloudflare Tunnel：
```
cloudflared
```
Tailscale：
```
tailscale
```

Usage

使用方法

Create a Tunnel

创建隧道

bash

{baseDir}/tunnel-manager.js create --provider cloudflare --name "my-tunnel"

bash

{baseDir}/tunnel-manager.js create --provider cloudflare --name "my-tunnel"

List Tunnels

列出隧道

bash

{baseDir}/tunnel-manager.js list

bash

{baseDir}/tunnel-manager.js list

Get Tunnel Status

获取隧道状态

bash

{baseDir}/tunnel-manager.js status --provider cloudflare --tunnel-id "tunnel-id"

bash

{baseDir}/tunnel-manager.js status --provider cloudflare --tunnel-id "tunnel-id"

Start Tunnel

启动隧道

bash

{baseDir}/tunnel-manager.js start --provider cloudflare --tunnel-id "tunnel-id" --port 3000

bash

{baseDir}/tunnel-manager.js start --provider cloudflare --tunnel-id "tunnel-id" --port 3000

Stop Tunnel

停止隧道

bash

{baseDir}/tunnel-manager.js stop --provider cloudflare --tunnel-id "tunnel-id"

bash

{baseDir}/tunnel-manager.js stop --provider cloudflare --tunnel-id "tunnel-id"

Delete Tunnel

删除隧道

bash

{baseDir}/tunnel-manager.js delete --provider cloudflare --tunnel-id "tunnel-id"

bash

{baseDir}/tunnel-manager.js delete --provider cloudflare --tunnel-id "tunnel-id"

Options

选项参数

Option	Description	Default
`--provider`	Tunnel provider: `cloudflare` , `tailscale` , `ngrok`	Required
`--name`	Tunnel name	Auto-generated
`--tunnel-id`	Tunnel identifier	-
`--port`	Local port to expose	80
`--subdomain`	Subdomain for Cloudflare	-
`--domain`	Domain for Cloudflare	-

选项	描述	默认值
`--provider`	隧道服务商： `cloudflare` 、 `tailscale` 、 `ngrok`	必填
`--name`	隧道名称	自动生成
`--tunnel-id`	隧道标识符	-
`--port`	要暴露的本地端口	80
`--subdomain`	Cloudflare子域名	-
`--domain`	Cloudflare域名	-

Providers

支持的服务商

Cloudflare Tunnel

Requires
```
cloudflared
```
CLI
Creates DNS records automatically
HTTPS with automatic certificate

需要安装
```
cloudflared
```
CLI
自动创建DNS记录
自动证书支持HTTPS

Tailscale

Requires
```
tailscale
```
CLI
Peer-to-peer connection
Uses Tailscale network

需要安装
```
tailscale
```
CLI
点对点连接
使用Tailscale网络

Ngrok

Requires
```
ngrok
```
CLI
Quick temporary tunnels
Shared/unique URLs available

需要安装
```
ngrok
```
CLI
快速创建临时隧道
支持共享/唯一URL

Response Format

返回格式

json

{
  "success": true,
  "provider": "cloudflare",
  "tunnelId": "tunnel-123",
  "name": "my-tunnel",
  "status": "running",
  "url": "https://my-tunnel.example.com"
}

json

{
  "success": true,
  "provider": "cloudflare",
  "tunnelId": "tunnel-123",
  "name": "my-tunnel",
  "status": "running",
  "url": "https://my-tunnel.example.com"
}

When to Use

使用场景

Exposing local servers to the internet
Secure tunnel without port forwarding
Multi-provider tunnel management
Development webhook testing
Temporary tunnel for testing

将本地服务器暴露至公网
无需端口转发的安全隧道
多服务商隧道统一管理
开发环境Webhook测试
临时测试隧道