跳转到内容
OpenChamber

远程实例

桌面应用可以通过 SSH 连接到运行在另一台机器上的 OpenChamber — 工作服务器、云主机、家庭实验室 — 并把它的 UI 带到你的屏幕上，仿佛它在本地一样。在 Settings → Remote Instances 中设置它。

远程实例是一项仅限桌面的功能。在网页端或 VS Code 中，请改用 OpenCode Server 中的环境变量连接到远程服务器。

添加远程实例

  1. 打开 Settings → Remote Instances 并添加一个。
  2. 给它你通常用来访问该机器的 SSH 命令，外加一个昵称。
  3. 选择 OpenChamber 在那里如何运行：
    • managed — OpenChamber 在远程机器上安装并启动它自己
    • external — 连接到一个已经运行的实例
  4. 连接。

OpenChamber 会引导你完成各个步骤 — 检查连接、设置远程、启动服务器并转发端口 — 并在每个阶段显示进度。当它到达 ready 时，远程 UI 会在本地加载。

凭证

你来决定是保存 SSH 和 UI 密码，还是每次都输入它们。如果连接断开，OpenChamber 会报告哪一步失败了，以便你修复它 — 参阅 远程访问。

连接链接

如果远程机器已经在运行 OpenChamber，把桌面应用连上去的最简单方式是配对链接。在远程服务器的 UI 中，打开 Settings → Remote Instances → 连接到此服务器 → 添加设备，创建一个链接，然后在你的桌面应用的 Settings → Remote Instances → 其他 OpenChamber 服务器 → 导入链接 中导入它。完整流程参阅 连接设备。

用 任何地方 创建的链接同时携带直接地址和一条 Private Relay 路由：当桌面应用能直接访问服务器时（同一网络）走直连，外出时回退到端到端加密的中继。每个已保存服务器旁边的状态会显示当前使用的是哪条路由。

你也可以在远程机器的终端里创建链接：

Terminal window
openchamber connect-url --port 3000 --server http://your-host:3000 --qr

如果该端口上没有服务器，connect-url 会先启动服务器。使用 --api-only 可启动 headless 服务器，--lan 可在启动时绑定到 LAN，--ui-password 可保护浏览器访问，--name 可为保存的连接命名。加上 --relay 可生成一条在本地网络之外也能使用的链接：设备在可达时优先直连，否则回退到 Private Relay — 实例会自行启动中继。

生成的链接包含一个一次性配对密钥。导入后，设备会持有自己的 client token — 独立于浏览器 UI 密码 — 它会在服务器重启后继续有效，直到你在签发它的服务器上撤销它。

相关内容