Bohdan Triapitsyn
6ec1797583
- --relay links now carry both routes: direct LAN plus relay fallback, matching the UI's Anywhere pairing; devices prefer the direct route - pairing sessions created by the CLI are marked with usesRelay, and the server reconciles relay demand on a timer, so a headless instance brings the relay up on its own after connect-url --relay - warn with LAN_UNREACHABLE when the link's direct route points at loopback and other devices cannot use it - document the --relay flow and the --lan binding caveat in Connect a Device and Remote Instances across all locales
69 lines
7.3 KiB
Plaintext
69 lines
7.3 KiB
Plaintext
---
|
|
title: Підключення пристрою
|
|
description: Зв'яжіть телефон, десктоп чи інший браузер зі своїм сервером OpenChamber за допомогою одноразового QR-коду.
|
|
---
|
|
|
|
# Підключення пристрою
|
|
|
|
Зв'яжіть інший пристрій — мобільний застосунок, десктопний застосунок чи браузер на іншій машині — зі своїм сервером OpenChamber, відсканувавши одноразовий QR-код. Це рекомендований спосіб підключати пристрої: не треба відкривати порти й вводити адреси.
|
|
|
|
## Як зв'язати пристрій
|
|
|
|
1. На машині, де запущено OpenChamber, відкрийте **Settings → Remote Instances → Підключення до цього сервера** й натисніть **Додати пристрій**.
|
|
2. Дайте пристрою назву (напр. *Мій iPhone*), щоб потім його впізнати.
|
|
3. Виберіть, де ви будете користуватись пристроєм:
|
|
- **Лише цей компʼютер** — для застосунків на цій самій машині
|
|
- **Лише домашня мережа** — підключається напряму через ваш Wi-Fi; поза цією мережею не працює
|
|
- **Будь-де** — працює вдома і поза домом; поза домом трафік іде через [Private Relay](/uk/private-relay/), наскрізно зашифрований тунель, який не потребує жодного налаштування
|
|
4. Натисніть **Створити QR-код**.
|
|
5. На іншому пристрої відскануйте код:
|
|
- **мобільний застосунок** — торкніться **Сканувати QR-код** на екрані підключення (або в списку інстансів)
|
|
- **десктопний застосунок** — натомість скопіюйте посилання для підключення та вставте його в **Settings → Remote Instances → Інші сервери OpenChamber → Імпортувати посилання**
|
|
|
|
Щойно пристрій підключається, діалог закривається сам, а пристрій з'являється в списку з живим статусом. Ось і все — пристрої зв'язано.
|
|
|
|
## Чому це безпечно
|
|
|
|
- **QR-код одноразовий.** Він перестає працювати, щойно якийсь пристрій його використав, і сам спливає, якщо не був використаний.
|
|
- **Кожен пристрій отримує власний токен.** Сканування коду ніколи не розкриває ваш пароль UI, а токен одного пристрою не можна використати, щоб видати себе за інший.
|
|
- **Контроль лишається у вас.** Кожен зв'язаний пристрій показано в списку з назвою, платформою і статусом підключення — будь-який можна відкликати в будь-який момент.
|
|
- **Трафік поза домом наскрізно зашифрований.** З опцією **Будь-де** трафік поза вашою мережею йде через [Private Relay](/uk/private-relay/), який не може прочитати те, що через нього проходить.
|
|
|
|
## Керування зв'язаними пристроями
|
|
|
|
**Settings → Remote Instances → Підключення до цього сервера** показує кожен пристрій, який може дістатися цього сервера, із зеленою крапкою, коли він онлайн, і позначкою, чи підключений він через локальну мережу, чи через relay.
|
|
|
|
- **Відкликати** миттєво відрізає пристрій. Якщо передумаєте — зв'яжіть його знову новим QR-кодом.
|
|
- **Очистити відкликані** прибирає зайве зі списку.
|
|
|
|
Той самий фізичний пристрій зберігає один запис, навіть якщо пізніше підключиться знову — дублікати не накопичуються.
|
|
|
|
## Підключення з командного рядка
|
|
|
|
Якщо сервер працює headless (без відкритого UI), створіть посилання для підключення з термінала на тій машині.
|
|
|
|
Для пристрою в тій самій мережі:
|
|
|
|
```bash
|
|
openchamber connect-url --port 3000 --qr
|
|
```
|
|
|
|
Для пристрою, який має підключатися **звідусіль** — еквівалент вибору **Будь-де** в діалозі:
|
|
|
|
```bash
|
|
openchamber connect-url --relay --qr
|
|
```
|
|
|
|
Посилання з `--relay` містить обидва маршрути, як і діалог: пристрій підключається напряму через вашу локальну мережу, коли може дістатися сервера, і переходить на [Private Relay](/uk/private-relay/), коли ви не вдома. Relay запускається сам: запущений інстанс підхоплює посилання протягом хвилини, зупинений — при наступному запуску.
|
|
|
|
> Прямий маршрут працює лише тоді, коли сервер справді слухає вашу мережу. За замовчуванням OpenChamber слухає тільки саму машину — запустіть його з `--lan`, щоб він був доступний через Wi-Fi. Команда попереджає (`[LAN_UNREACHABLE]`), коли прямим маршрутом посилання не зможуть скористатися інші пристрої; посилання з `--relay` тоді все одно працює, просто завжди через relay.
|
|
|
|
Надруковані посилання та QR-код працюють точнісінько як ті, що з діалогу налаштувань — одноразові, зі строком дії, з можливістю відкликання.
|
|
|
|
## Пов'язане
|
|
|
|
- [Private Relay](/uk/private-relay/) — як працюють підключення «Будь-де» і що relay може та не може бачити
|
|
- [Мобільні застосунки](/uk/mobile/) — установіть застосунок для iOS чи Android
|
|
- [Віддалені інстанси](/uk/remote-instances/) — підключайте десктопний застосунок до серверів через SSH або посилання
|
|
- [Віддалений доступ](/uk/troubleshooting/remote-access/) — коли пристрій не підключається
|