隧道

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

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

前置要求

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

brew install cloudflared
brew install ngrok

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

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

快速开始

启动 Varin：

varin

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

启动 Cloudflare 隧道：

varin tunnel start --provider cloudflare --mode quick

或启动 Ngrok 隧道：

varin tunnel start --provider ngrok --mode quick

查看状态：

varin tunnel status

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

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

提供商

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

托管模式

托管远程

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

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

托管本地

使用本地的 cloudflared 配置：

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

配置文件（managed-remote）

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

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

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

varin tunnel start --profile prod-main

实用命令

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

行为说明

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

隧道