ОКАкадемия OpenChamber
← Документация

Удалённые инстансы

Подключите десктопное приложение к OpenChamber на другой машине по SSH.

Раздел: desktop · Статус: draft · Релиз-проверка: v1.18.2

Удалённые инстансы

Десктопное приложение может подключиться по SSH к OpenChamber, запущенному на другой машине, — рабочий сервер, облачная коробка, homelab — и показать его 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 → Connect to this server → Add a device, создайте ссылку и импортируйте её на десктопе в Settings → Remote Instances → Other OpenChamber servers → Import Link. Полный процесс см. в Подключение устройства.

Ссылка, созданная с Anywhere, несёт и прямой адрес, и маршрут Private Relay: десктоп подключается напрямую, когда может достать сервер (та же сеть), и откатывается на сквозно зашифрованный релей, когда вы вдали от дома. Статус рядом с каждым сохранённым сервером показывает, какой маршрут используется.

Ссылку можно также создать из терминала на удалённой машине:

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

connect-url сам запускает сервер, если на этом порту ничего не запущено. Добавьте --api-only для headless-сервера, --lan для привязки к LAN при запуске, --ui-password для защиты браузерного доступа и --name для подписи сохранённого соединения. Добавьте --relay для ссылки, работающей и вдали от локальной сети: устройство предпочитает прямое соединение, когда оно достижимо, и откатывается на Private Relay — инстанс сам поднимает релей.

Сгенерированная ссылка содержит одноразовый секрет спаривания. После импорта устройство держит собственный клиентский токен — отдельный от пароля браузерного UI — который переживает перезапуски сервера, пока вы не отзовёте его на выдающем сервере.

Связанное