连接设备

通过扫描一次性二维码，把另一台设备 — 移动应用、桌面应用，或另一台机器上的浏览器 — 与你的 OpenChamber 服务器配对。这是连接设备的推荐方式；无需开放端口，也无需输入地址。

配对设备

1. 在运行 OpenChamber 的机器上，打开 Settings → Remote Instances → 连接到此服务器，然后按 添加设备。
2. 给设备起一个名字（例如 My iPhone），方便你以后辨认。
3. 选择你会在哪里使用这台设备：
   • 仅本机 — 供同一台电脑上的应用使用
   • 仅家庭网络 — 通过 Wi-Fi 直接连接；离开此网络后无法使用
   • 任何地方 — 在家和外出都可用；外出时流量经由 Private Relay 传输，这是一条端到端加密的隧道，无需任何配置
4. 按 创建二维码。
5. 在另一台设备上扫描该二维码：
   • 移动应用 — 在连接页面（或实例列表中）点击 扫描二维码
   • 桌面应用 — 改为复制连接链接，并在 Settings → Remote Instances → 其他 OpenChamber 服务器 → 导入链接 中粘贴

设备一连上，对话框就会自动关闭，设备也会出现在列表中并显示实时状态。就这么简单 — 配对完成。

配对为何安全

• 二维码只能使用一次。 一旦被某台设备兑换就立即失效；从未使用也会自行过期。
• 每台设备都有自己的令牌。 扫码不会暴露你的 UI 密码，一台设备的令牌也无法用来冒充另一台设备。
• 控制权始终在你手上。 每台已配对的设备都会显示名称、平台和连接状态 — 你可以随时撤销任何一台。
• 外出流量端到端加密。 使用 任何地方 时，网络之外的流量经由 Private Relay 传输，中继无法读取任何经过它的内容。

管理已配对的设备

Settings → Remote Instances → 连接到此服务器 会列出所有可以访问此服务器的设备，在线时显示绿点，并标明它是通过本地网络还是中继连接的。

• 撤销 会立即切断该设备的访问。如果你改变主意，用新的二维码重新配对即可。
• 清除已撤销 用来整理列表。

同一台物理设备即使日后重新登录也只保留一个条目 — 不会积累重复项。

从命令行连接

如果服务器以 headless 方式运行（没有打开 UI），可以在那台机器的终端里创建连接链接。

针对同一网络中的设备：

openchamber connect-url --port 3000 --qr

针对需要从任何地方连接的设备 — 相当于在对话框中选择 任何地方：

openchamber connect-url --relay --qr

--relay 链接与对话框一样同时携带两条路由：当设备能访问服务器时，通过你的本地网络直接连接；外出时则回退到 Private Relay。中继会自行启动：正在运行的实例会在一分钟内接管该链接，已停止的实例则会在下次启动时接管。

直连路由只有在服务器确实监听你的网络时才有效。默认情况下 OpenChamber 只监听本机 — 用 --lan 启动它，才能通过 Wi-Fi 访问。当链接的直连路由无法被其他设备使用时，命令会发出警告（[LAN_UNREACHABLE]）；此时 --relay 链接仍然可用，只是始终通过中继连接。

打印出的链接和二维码与设置对话框里生成的完全一样 — 一次性使用、会过期、可撤销。

相关内容

• Private Relay — “任何地方”连接的工作原理，以及中继能看到和看不到什么
• 移动应用 — 安装 iOS 或 Android 应用
• 远程实例 — 让桌面应用通过 SSH 或链接连接到服务器
• 远程访问 — 当设备无法连接时