← Документация

Подключить устройство

Сопрягите свой телефон, десктоп или другой браузер с сервером OpenChamber с помощью одноразового QR-кода.

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

Подключить устройство

Сопрягите другое устройство — мобильное приложение, десктопное приложение или браузер на другой машине — с вашим сервером OpenChamber, отсканировав одноразовый QR-код. Это рекомендуемый способ подключения устройств: не нужно открывать порты и вводить адреса.

Сопряжение устройства

  1. На машине, где запущен OpenChamber, откройте Settings → Remote Instances → Connect to this server и нажмите Add a device.
  2. Дайте устройству имя (например, My iPhone), чтобы узнать его позже.
  3. Выберите, где вы будете использовать устройство:
    • This computer only — для приложений, запущенных на этой же машине
    • Home network only — подключается напрямую через ваш Wi-Fi; не работает вне этой сети
    • Anywhere — работает дома и в الخارج; трафик вдали идет через Private Relay, сквозно зашифрованный туннель без необходимости настройки
  4. Нажмите Create QR code.
  5. На другом устройстве отсканируйте код:
    • mobile app — нажмите Scan QR code на экране подключения (или в списке инстансов)
    • desktop app — скопируйте ссылку подключения и вставьте её в Settings → Remote Instances → Other OpenChamber servers → Import Link

Диалог закрывается автоматически, как только устройство подключится, и устройство появится в списке с актуальным статусом. Всё — вы сопряжены.

Почему сопряжение безопасно

  • QR-код одноразовый. Он перестает работать в момент, когда устройство его использует, и истекает сам, если не был использован.
  • Каждое устройство получает свой токен. Сканирование кода никогда не раскрывает ваш пароль UI, и токен одного устройства нельзя использовать для выдачи себя за другое.
  • Вы остаетесь в контроле. Каждое сопряженное устройство отображается со своим именем, платформой и статусом подключения — отозвать любое из них можно в любой момент.
  • Трафик вне дома сквозно зашифрован. С Anywhere трафик вне вашей сети идет через Private Relay, который не может прочитать то, что проходит через него.

Управление сопряженными устройствами

Settings → Remote Instances → Connect to this server показывает все устройства, которые могут достичь этого сервера, с зеленой точкой, когда они онлайн, и указанием, подключены ли они через локальную сеть или через релей.

  • Revoke немедленно отключает устройство. Сопрягите его снова с новым QR-кодом, если передумаете.
  • Clear revoked очищает список.

То же физическое устройство сохраняет одну запись, даже если оно входит снова позже — дубликаты не накапливаются.

Подключение из командной строки

Если сервер работает без UI (headless, без открытого интерфейса), создайте ссылку подключения из терминала на этой машине.

Для устройства в той же сети:

openchamber connect-url --port 3000 --qr

Для устройства, которое должно подключаться откуда угодно — эквивалент выбора Anywhere в диалоге:

openchamber connect-url --relay --qr

Ссылка с --relay несет оба маршрута, как и диалог: устройство подключается напрямую через вашу локальную сеть, когда может достичь сервера, и переключается на Private Relay вдали. Релей запускается сам: запущенный инстанс подхватывает ссылку в течение минуты, остановленный — при следующем запуске.

Прямой маршрут работает только если сервер действительно слушает вашу сеть. По умолчанию OpenChamber слушает только локальную машину — запустите его с --lan, чтобы сделать его доступным через Wi-Fi. Команда предупреждает ([LAN_UNREACHABLE]), когда прямой маршрут ссылки не будет пригоден с других устройств; ссылка --relay все равно работает, просто всегда через релей.

Напечатанная ссылка и QR-код работают точно так же, как из диалога настроек — одноразовые, истекающие, отзываемые.

Связанное

  • Private Relay — как работают подключения “Anywhere” и что релей может и не может видеть
  • Mobile Apps — установите iOS или Android приложение
  • Remote Instances — подключите десктопное приложение к серверам через SSH или ссылки
  • Remote access — когда устройство не подключается