Przejdź do głównej zawartości

Sparuj urządzenie

Ten poradnik pokazuje, jak sparować telefon z Control Center, aby czytać wiadomości i zgłoszenia oraz odpowiadać z dowolnego miejsca. Ten sam przepływ pozwala sparować drugą przeglądarkę lub aplikację desktopową. Zobacz Zdalne sterowanie i mobile, aby poznać działanie tego połączenia i jego model bezpieczeństwa.

  • Klient desktopowy lub webowy połączony z serwerem oraz skonfigurowany obszar roboczy. Operacje parowania wymagają pełnego klienta, więc sparowany telefon nigdy nie może sparować — ani odwołać — innego urządzenia.
  • Serwer osiągalny z urządzenia, które parujesz. W tej samej sieci działa to od razu; z dalszej odległości ruch niesie brokerski przekaźnik. Jeśli panel odpowiada Nieosiągalny zamiast kodu QR lub danych logowania, najpierw opublikuj ścieżkę — opcję włączenia tunelu w Ustawienia → Serwer → Połączenie i status (Udostępnij ten serwer) albo parametr --public-url serwera (zobacz Uruchom serwer headless).
  • W przypadku telefonu: nic nie trzeba instalować. Kod QR otwiera aplikację webową Remote (domyślnie remote.usectrl.dev).

Własny hosting. Aplikacja Remote i brokerski przekaźnik są otwartoźródłowe w tym repozytorium: aplikacja na telefon (apps/cc_remote, webowa PWA we Flutterze, którą możesz wdrożyć na Cloudflare Pages przez jej wrangler.jsonc, do obrazu nginx docker/cc_remote albo na dowolny statyczny host z HTTPS — service workery i IndexedDB są ograniczone do bezpiecznego kontekstu) oraz przekaźnik (apps/cc_signaling_server, pojedyncza bezstanowa binarka Darta, która nie przechowuje żadnych danych aplikacji i nigdy nie widzi sekretu parowania — przekazuje wyłącznie ramki zamknięte end-to-end). Kroki budowania i uruchamiania znajdziesz w ich plikach README.

Otwórz Ustawienia → Ty → Twoje urządzenia. Sekcja Twoje urządzenia zawiera listę klientów sparowanych z Twoim kontem na tym serwerze. (Właściciel serwera widzi każde urządzenie na serwerze; każdy inny widzi tylko swoje.)

Kliknij Sparuj nowego klienta w nagłówku strony, nadaj mu etykietę (np. „Mój telefon”), wybierz typ — Przeglądarka internetowa, Aplikacja desktopowa lub Telefon — i kliknij Sparuj.

  • W przypadku telefonu pojawia się kod QR. Zeskanuj go aparatem telefonu albo skopiuj link i otwórz go w dowolnej przeglądarce. Wskazuje on aplikacji Remote Twój serwer i zawiera poświadczenie.
  • W przypadku przeglądarki lub komputera skopiuj zamiast tego pokazany link (albo identyfikator urządzenia i klucz parowania) do nowego klienta. Link jednoklikowy jest oferowany tylko wtedy, gdy parujesz z klienta webowego, ponieważ binarka desktopowa nie ma origin webowego, z którego można go zbudować.

Kod QR telefonu i link, który wypisuje cc_server pair --client-url w CLI, to różne ładunki i nie są wymienne: link z CLI wypełnia formularz połączenia klienta webowego, a ten kod QR przenosi pełny deskryptor połączenia serwera i odcisk tożsamości dla PWA Remote.

Po stronie telefonu otwarcie linku parowania nie paruje po cichu. Remote pokazuje ogłaszaną nazwę serwera i prosi o potwierdzenie, zanim cokolwiek zapisze, więc podrobiony link nie może przejąć aplikacji na serwer kogoś innego.

W Ustawienia → Ty → Twoje urządzenia możesz:

  • Zmień nazwę urządzenia
  • Cofnij urządzenie, któremu już nie ufasz. Odwołanie niszczy jego poświadczenie i w ciągu kilku sekund zrywa jego aktywną sesję, więc przy ponownym połączeniu kończy się odmową

Odwołanie to właściwy krok w razie zgubionego lub wymienionego telefonu. Z perspektywy urządzenia jest natychmiastowe i nieodwracalne.

Poświadczenia utworzone w tym panelu mają ograniczony czas ważności: wygasają 30 dni po wydaniu, a po tym czasie brama połączenia je odrzuca. Poświadczenie utworzone poleceniem cc_server pair w wierszu poleceń nie ma żadnego terminu ważności — odwołaj je ręcznie, gdy maszyna, dla której było przeznaczone, zostanie wycofana.

Sparowany telefon może przełączać się między obszarami roboczymi niezależnie od komputera. Telefon wysyła obszar roboczy przy każdym wywołaniu, a serwer przy każdym z nich sprawdza Twoje członkostwo i rolę w tym obszarze roboczym — dzięki temu telefon dociera tylko do obszarów roboczych, których jesteś członkiem, a przełączanie na nim nigdy nie zmienia tego, co pokazuje komputer.

Sesja telefonu jest dodatkowo ograniczona do niewielkiej listy dozwolonych narzędzi nastawionych na odczyt: może wyświetlać i czytać zgłoszenia, agentów, przestrzenie, wiadomości i artykuły newsfeedu, a także aktualizować lub przypisywać zgłoszenie, wysłać wiadomość w przestrzeni oraz oznaczyć artykuł jako przeczytany lub zapisany. Wszystko spoza tego zbioru jest odrzucane, zanim dotrze do dyspozytora serwera.