Прив’язати пристрій

Цей посібник показує, як спарувати телефон із Control Center, щоб читати повідомлення й тікети та відповідати звідки завгодно. Той самий процес спаровує другий браузер чи настільний застосунок. Про те, як працює це з’єднання та яка в нього модель безпеки, див. Віддалене керування та мобільний клієнт.

Перш ніж почати

Настільний або вебклієнт, під’єднаний до вашого сервера, і налаштований робочий простір. Операції спарювання потребують повноцінного клієнта, тож спарований телефон ніколи не може спарувати — чи відкликати — інший пристрій.
Сервер, доступний із пристрою, який ви спаровуєте. У межах однієї мережі це працює просто так; здалеку трафік переносить реле з брокером. Якщо панель відповідає Недоступний замість QR-коду чи облікових даних, спершу відкрийте шлях — увімкнення тунелю в Налаштування → Сервер → Підключення та стан (Надати доступ до цього сервера), або --public-url сервера (див. Запустити headless-сервер).
Для телефону: нічого встановлювати не треба. QR-код відкриває вебзастосунок Remote (remote.usectrl.dev за замовчуванням).

Самостійне розміщення. Remote і реле з брокером — відкритий код у цьому репозиторії: телефонний застосунок (apps/cc_remote, Flutter-веб-PWA, який можна розгорнути на Cloudflare Pages через його wrangler.jsonc, в nginx-образ docker/cc_remote або на будь-який статичний хост з HTTPS — service workers і IndexedDB доступні лише в захищеному контексті) і реле (apps/cc_signaling_server, єдиний бінарник Dart без стану, який не тримає даних застосунку й ніколи не бачить секрету спарювання — він пересилає лише кадри, запечатані наскрізним шифруванням). Кроки збірки та запуску див. у їхніх README.

Крок 1: Відкрити панель спарювання

Відкрийте Налаштування → Ви → Ваші пристрої. Розділ Ваші пристрої перелічує клієнти, спаровані з вашим обліковим записом на цьому сервері. (Власник сервера бачить усі пристрої на сервері; решта бачать лише свої.)

Крок 2: Спарувати новий клієнт

Натисніть Спарувати новий клієнт у заголовку сторінки, дайте йому мітку (наприклад, «Мій телефон»), виберіть тип — Веббраузер, Настільна програма чи Телефон — і натисніть Спарувати.

Для телефону з’являється QR-код. Відскануйте його камерою телефону або скопіюйте посилання та відкрийте його в будь-якому браузері. Воно націлює застосунок Remote на ваш сервер і несе облікові дані.
Для браузера чи настільної програми натомість скопіюйте показане посилання (або ідентифікатор пристрою та ключ спарювання) у новий клієнт. Посилання в один дотик пропонують лише тоді, коли ви спаровуєте з вебклієнта, бо настільний бінарник не має вебджерела, з якого його можна було б скласти.

QR-код телефону й посилання, яке cc_server pair --client-url друкує в CLI, — це різні навантаження, і вони не взаємозамінні: посилання CLI заповнює форму під’єднання вебклієнта, а цей QR-код несе повний дескриптор з’єднання сервера та відбиток його ідентичності для Remote PWA.

На боці телефону відкриття посилання спарювання не спаровує мовчки. Remote показує оголошену назву сервера й просить підтвердити, перш ніж щось зберегти, тож підроблене посилання не може перехопити застосунок на чужий сервер.

Керувати спарованими пристроями

З розділу Налаштування → Ви → Ваші пристрої ви можете:

Перейменувати пристрій
Відкликати пристрій, якому більше не довіряєте. Відкликання знищує його облікові дані й розриває його живий сеанс за секунди, тож під час повторного з’єднання він відмовляє, а не пропускає

Відкликання — правильний крок для загубленого чи заміненого телефону. З погляду пристрою воно миттєве й незворотне.

Облікові дані, створені з цієї панелі, обмежені в часі: вони спливають через 30 днів після видачі, і після цього шлюз з’єднання відхиляє їх, а не пропускає. Облікові дані, створені командою cc_server pair у командному рядку, не мають жодного строку дії — відкличте їх вручну, коли машину, для якої їх видали, виводять з експлуатації.

Перемикати робочі простори з телефону

Спарований телефон може перемикатися між робочими просторами незалежно від настільного клієнта. Телефон надсилає робочий простір із кожним викликом, і сервер щоразу перевіряє ваше членство та роль у цьому робочому просторі — тож телефон дістає лише ті робочі простори, учасником яких ви є, і перемикання на ньому ніколи не змінює того, що показує настільний клієнт.

Телефонний сеанс додатково обмежено невеликим списком дозволених інструментів, переважно для читання: він може перелічувати й читати тікети, агентів, простори, повідомлення та статті стрічки, а також оновлювати чи призначати тікет, надсилати повідомлення в просторі та позначати статтю прочитаною чи збереженою. Усе поза цим набором відхиляють, перш ніж воно дійде до диспетчера сервера.

Пов’язані посібники

Запустити headless-сервер: щоб сервер узагалі став доступним
Під’єднатися до віддаленого сервера: націлити на нього повноцінний клієнт
Використовувати простори: те, що ви здебільшого робитимете з телефону
Створювати й керувати тікетами: розбирати з дороги