跳转到正文

常见问题解答

我的数据会经过别人的服务器吗?

Termbridge 服务器和你的终端都在你的计算机上运行,并且没有由 Termbridge 运营的后端。在默认设置下,你的终端流量确实会经过 Cloudflare:浏览器通过 HTTPS 连接到 Cloudflare Quick Tunnel,再由它转发到你计算机上的 cloudflared 进程(参见架构)。使用命名隧道时,流量会经过你自己的 Cloudflare 账户;使用 --no-tunnel 时,流量则会经过为你的公共 URL 提供服务的任何平台。

在 Daytona 沙盒模式下,终端会在你的 Daytona 账户的沙盒中运行。在直连模式下,浏览器通过 Daytona 预览链接连接,而不是通过 Cloudflare。

连接安全吗?

  • URL 包含一次性令牌,只能使用一次,并会在启动 90 秒后过期
  • 会话由 HttpOnly Cookie 保护
  • 隧道 URL(Cloudflare 或 Daytona 预览链接)使用 HTTPS;使用 --no-tunnel 时,加密方式取决于你提供的公共 URL

会话不会自动过期。它们存储在系统临时目录中的 termbridge/sessions.json 中,因此只要浏览器还能访问同一个 URL,兑换过链接的浏览器就会一直保有访问权限。删除该文件并重启 Termbridge,即可让所有浏览器退出登录。不要与不信任的人分享 QR 代码或 URL。

可以同时运行多个终端吗?

可以。使用 TERMBRIDGE_SESSIONS=3 启动 Termbridge(或使用 --session 接入现有会话),然后在 UI 中使用终端切换器在它们之间切换。参见多个终端。

它能与 Claude Code、Codex 或其他 AI 工具配合使用吗?

当然可以。只要能在终端中运行,Termbridge 就能串流显示它。在 tmux 会话中启动你的 AI 编程工具,就可以通过手机监控它。

它能在 Windows 上运行吗?

官方暂不支持。Termbridge 是为 macOS 和 Linux 构建的。它可能能在 WSL 中运行,但尚未经过测试。

可以使用其他隧道服务商吗?

目前还不行——Cloudflare 是目前唯一的隧道服务商。你也可以完全禁用隧道,或使用 Daytona 直连模式。

合上笔记本电脑会怎样?

在本地模式下,只要 Termbridge 正在运行,隧道就会保持活动状态。如果计算机进入睡眠状态或 Termbridge 退出,连接就会关闭。不过,你的 tmux 会话会继续运行,因此你可以重启 Termbridge 并重新连接。在 Daytona 直连模式下,服务器在沙盒中运行,所以你可以合上笔记本电脑,稍后再重新连接。

多人可以同时连接吗?

单个链接不行。每次运行都会生成一个共享链接,而且只能使用一次:最先打开链接的人会获得会话,其他人则会看到 invalid token。不重启 Termbridge 就无法生成第二个链接。

如果你重启并保留相同的公共 URL(命名隧道或 --public-url),之前连接过的浏览器会保留会话,因此第二个人可以扫描新代码。所有连接到同一终端的人都能看到相同的输出并输入内容。Quick Tunnel 每次启动都会获得新的 URL,因此之前连接的浏览器必须重新扫描。