隧道

隧道是指向你的 OpenChamber 的一个公开链接，让你可以在另一个网络上用普通浏览器访问它。使用 openchamber tunnel 为正在运行的实例创建一个隧道。

连接你自己的设备（移动应用、另一台桌面设备）通常不需要隧道 — 改为配对它们，让端到端加密的 Private Relay 零配置地处理外出访问。

前置要求

OpenChamber 会在你的机器上启动隧道提供商的 CLI。请先安装你想使用的提供商：

brew install cloudflared
brew install ngrok

Cloudflare 快速隧道可以通过 cloudflared 运行。Ngrok 需要 ngrok 账号，以及从 ngrok dashboard 获取的 authtoken：

ngrok config add-authtoken <your-ngrok-token>

快速开始

启动 OpenChamber：

openchamber

如果跳过这一步，openchamber tunnel start 可以自动启动 CLI 服务器。自动启动时可以传入服务器选项，例如 --port、--host、--lan、--ui-password 和 --api-only。

启动 Cloudflare 隧道：

openchamber tunnel start --provider cloudflare --mode quick

或启动 Ngrok 隧道：

openchamber tunnel start --provider ngrok --mode quick

查看状态：

openchamber tunnel status

隧道建立后，status 会显示一个公开 URL。打开它，或扫描二维码，即可从任何地方访问 OpenChamber。

默认情况下，OpenChamber 会在交互式 TTY 会话中输出二维码。使用 --qr 强制输出二维码，或使用 --no-qr 将其禁用。

提供商

cloudflare：quick、managed remote 和 managed local 模式
ngrok：quick 模式

托管模式

托管远程

使用由 Cloudflare 托管的令牌 + 主机名：

openchamber tunnel start --provider cloudflare --mode managed-remote --token-file ~/.secrets/cf-token --hostname app.example.com

托管本地

使用本地的 cloudflared 配置：

openchamber tunnel start --provider cloudflare --mode managed-local --config ~/.cloudflared/config.yml

配置文件（managed-remote）

保存一个可重用的配置文件：

openchamber tunnel profile add --provider cloudflare --mode managed-remote --name prod-main --hostname app.example.com --token-file ~/.secrets/cf-token

使用已保存的配置文件启动：

openchamber tunnel start --profile prod-main

实用命令

openchamber tunnel providers
openchamber tunnel ready --provider cloudflare
openchamber tunnel ready --provider ngrok
openchamber tunnel doctor --provider cloudflare
openchamber tunnel doctor --provider ngrok
openchamber tunnel stop --port 3000

行为说明

每个 OpenChamber 实例（端口）只有一个活动隧道
在同一实例上启动新的模式/提供商会替换之前的隧道
生成新的连接链接会吊销之前未使用的链接

隧道