docs: centralize device connection guides, add private relay docs

- new Connect a Device page: one-time QR pairing, transport choices, device management - new Private Relay page: E2EE guarantees, demand-driven lifecycle, relay vs tunnel - rewrite mobile page around the native iOS/Android apps (TestFlight + APK) - update remote-instances, security, tunnels, and remote-access troubleshooting to point at the new pairing flow - translate everything across all 8 locales and update the sidebar
2026-07-10 15:30:50 +03:00
parent b3fa19fe3e
commit 7ea974d89b
64 changed files with 1452 additions and 190 deletions
@@ -0,0 +1,56 @@
+---
+title: Połącz urządzenie
+description: Sparuj telefon, komputer lub inną przeglądarkę ze swoim serwerem OpenChamber za pomocą jednorazowego kodu QR.
+---
+
+# Połącz urządzenie
+
+Sparuj inne urządzenie — aplikację mobilną, aplikację desktopową lub przeglądarkę na innej maszynie — ze swoim serwerem OpenChamber, skanując jednorazowy kod QR. To zalecany sposób łączenia urządzeń: nie ma portów do otwierania ani adresów do wpisywania.
+
+## Sparuj urządzenie
+
+1. Na maszynie z uruchomionym OpenChamber otwórz **Settings → Remote Instances → Połącz z tym serwerem** i naciśnij **Dodaj urządzenie**.
+2. Nadaj urządzeniu nazwę (np. *Mój iPhone*), by później je rozpoznać.
+3. Wybierz, gdzie będziesz go używać:
+   - **Tylko ten komputer** — dla aplikacji działających na tej samej maszynie
+   - **Tylko sieć domowa** — łączy się bezpośrednio przez Wi-Fi; nie działa poza tą siecią
+   - **Wszędzie** — działa w domu i poza nim; poza domem ruch przechodzi przez [Private Relay](/pl/private-relay/), szyfrowany end-to-end tunel bez żadnej konfiguracji
+4. Naciśnij **Utwórz kod QR**.
+5. Na drugim urządzeniu zeskanuj kod:
+   - **aplikacja mobilna** — stuknij **Skanuj kod QR** na ekranie łączenia (lub na liście instancji)
+   - **aplikacja desktopowa** — zamiast tego skopiuj link połączenia i wklej go w **Settings → Remote Instances → Inne serwery OpenChamber → Importuj link**
+
+Okno dialogowe zamknie się samo, gdy tylko urządzenie się połączy, a urządzenie pojawi się na liście z bieżącym statusem. To wszystko — jesteście sparowani.
+
+## Dlaczego parowanie jest bezpieczne
+
+- **Kod QR jest jednorazowy.** Przestaje działać w momencie, gdy urządzenie go wykorzysta, a jeśli nikt go nie użyje — sam wygasa.
+- **Każde urządzenie dostaje własny token.** Zeskanowanie kodu nigdy nie ujawnia Twojego hasła UI, a token jednego urządzenia nie pozwala podszyć się pod inne.
+- **Kontrola zostaje u Ciebie.** Każde sparowane urządzenie jest widoczne na liście z nazwą, platformą i statusem połączenia — możesz unieważnić dowolne z nich w każdej chwili.
+- **Ruch poza domem jest szyfrowany end-to-end.** Przy opcji **Wszędzie** ruch spoza Twojej sieci przechodzi przez [Private Relay](/pl/private-relay/), który nie może odczytać tego, co przez niego przepływa.
+
+## Zarządzaj sparowanymi urządzeniami
+
+**Settings → Remote Instances → Połącz z tym serwerem** pokazuje każde urządzenie, które może dotrzeć do tego serwera — z zieloną kropką, gdy jest online, oraz informacją, czy łączy się przez sieć lokalną, czy przez relay.
+
+- **Unieważnij** natychmiast odcina urządzenie. Jeśli zmienisz zdanie, sparuj je ponownie nowym kodem QR.
+- **Wyczyść unieważnione** porządkuje listę.
+
+To samo fizyczne urządzenie zachowuje jeden wpis, nawet jeśli zaloguje się ponownie później — duplikaty się nie mnożą.
+
+## Połącz z wiersza poleceń
+
+Jeśli serwer działa headless (bez otwartego UI), utwórz link połączenia z terminala na tej maszynie:
+
+```bash
+openchamber connect-url --port 3000 --qr
+```
+
+Wypisany link i kod QR działają dokładnie tak samo jak te z okna ustawień.
+
+## Powiązane
+
+- [Private Relay](/pl/private-relay/) — jak działają połączenia „Wszędzie" i co relay może, a czego nie może zobaczyć
+- [Aplikacje mobilne](/pl/mobile/) — zainstaluj aplikację na iOS lub Androida
+- [Zdalne instancje](/pl/remote-instances/) — połącz aplikację desktopową z serwerami przez SSH lub linki
+- [Dostęp zdalny](/pl/troubleshooting/remote-access/) — gdy urządzenie nie chce się połączyć
@@ -1,25 +1,36 @@
 ---
-title: PWA i dostęp z telefonu
-description: Zainstaluj OpenChamber jako aplikację i używaj go z telefonu.
+title: Aplikacje mobilne i PWA
+description: Zainstaluj aplikację OpenChamber na iOS lub Androidzie i połącz ją ze swoim serwerem.
 ---

-# PWA i dostęp z telefonu
+# Aplikacje mobilne i PWA

-Aplikacja webowa OpenChamber instaluje się jak aplikacja na telefonie (PWA), więc możesz trzymać ją na ekranie głównym i używać jej na pełnym ekranie. Połącz to z [tunelem](/pl/tunnels/), a będziesz mógł zajrzeć do sesji z dowolnego miejsca.
+OpenChamber ma natywne aplikacje na iPhone'a i Androida, więc możesz obserwować sesje, odpowiadać agentom i zarządzać pracą z telefonu — w domu przez Wi-Fi lub z dowolnego miejsca przez [Private Relay](/pl/private-relay/).

-## Zainstaluj ją
+## Zainstaluj aplikację

-OpenChamber korzysta z wbudowanej instalacji Twojej przeglądarki, więc nie ma osobnego pobierania:
+- **iPhone/iPad** — dołącz do [bety TestFlight](https://testflight.apple.com/join/5ek6GU1E)
+- **Android** — pobierz APK z [najnowszego wydania](https://github.com/openchamber/openchamber/releases/latest)
+
+## Połącz ją ze swoim serwerem
+
+1. Na komputerze z uruchomionym OpenChamber otwórz **Settings → Remote Instances → Połącz z tym serwerem** i naciśnij **Dodaj urządzenie**.
+2. Wybierz **Wszędzie** (lub **Tylko sieć domowa**, jeśli będziesz używać telefonu tylko w domu) i naciśnij **Utwórz kod QR**.
+3. W aplikacji mobilnej stuknij **Skanuj kod QR** i skieruj aparat na kod.
+
+Aplikacja łączy się i zapamiętuje serwer. Kod QR jest jednorazowy, a każde urządzenie dostaje własny, możliwy do unieważnienia token — zobacz [Połącz urządzenie](/pl/connect-devices/), aby dowiedzieć się, dlaczego parowanie jest bezpieczne.
+
+Możesz sparować aplikację z kilkoma serwerami i przełączać się między nimi z listy instancji; aplikacja pokazuje dla każdego z nich, czy jest osiągalny i czy łączysz się przez sieć lokalną, czy przez relay.
+
+## PWA (instalacja z przeglądarki)
+
+Wolisz obejść się bez sklepu z aplikacjami? Aplikacja webowa instaluje się prosto z przeglądarki:

 - **przeglądarka na komputerze** — użyj opcji **Install** w pasku adresu
 - **iPhone/iPad (Safari)** — Udostępnij → **Dodaj do ekranu początkowego**
 - **Android (Chrome)** — menu → **Zainstaluj aplikację** / **Dodaj do ekranu głównego**

-Po zainstalowaniu otwiera się we własnym oknie, bez elementów przeglądarki.
-
-## Dotrzyj do niej z telefonu
-
-Aby otworzyć OpenChamber na telefonie, gdy serwer działa na Twoim komputerze, uruchom [tunel](/pl/tunnels/) i otwórz link (lub zeskanuj kod QR) na telefonie. Używaj silnego [hasła UI](/pl/security/), gdy tylko to robisz.
+Aby dotrzeć do PWA spoza swojej sieci, potrzebujesz [tunelu](/pl/tunnels/) i silnego [hasła UI](/pl/security/) — natywne aplikacje załatwiają to za Ciebie przez relay.

 ## Ustawienia mobilne

@@ -27,5 +38,6 @@ W **Settings → OpenChamber** kilka opcji dostraja działanie na telefonie i za

 ## Powiązane

- [Tunele](/pl/tunnels/) — dotrzyj do swojej instancji z innej sieci
+- [Połącz urządzenie](/pl/connect-devices/) — parowanie, jednorazowe kody QR i zarządzanie urządzeniami
+- [Private Relay](/pl/private-relay/) — jak działa dostęp „Wszędzie"
 - [Bezpieczeństwo](/pl/security/) — zabezpiecz UI przed udostępnieniem
@@ -0,0 +1,44 @@
+---
+title: Private Relay
+description: Dotrzyj do swojego serwera OpenChamber z dowolnego miejsca przez szyfrowany end-to-end relay — bez portów, tuneli i konfiguracji.
+---
+
+# Private Relay
+
+OpenChamber Private Relay pozwala Twoim sparowanym urządzeniom dotrzeć do serwera z dowolnego miejsca — z sieci komórkowej, kawiarnianego Wi-Fi, innego miasta — bez otwierania portów, konfigurowania tunelu czy wystawiania maszyny do internetu. Zarządza sobą sam: wystarczy sparować urządzenie z opcją **Wszędzie** w [Połącz urządzenie](/pl/connect-devices/).
+
+## Jak to działa
+
+Twój serwer otwiera wychodzące połączenie do infrastruktury relay OpenChamber i utrzymuje je aktywne. Gdy jedno z Twoich urządzeń jest poza Twoją siecią, również łączy się z relayem, a relay przekazuje zaszyfrowany ruch między nimi. Nic na Twojej maszynie nie nasłuchuje na połączenia przychodzące z internetu.
+
+Gdy dostępne jest połączenie bezpośrednie — jesteś z powrotem w domu, w tej samej sieci Wi-Fi — Twoje urządzenia wybierają je i całkowicie pomijają relay.
+
+## Co relay może, a czego nie może zobaczyć
+
+Relay to ślepy kurier, a nie pośrednik:
+
+- **Szyfrowanie end-to-end.** Twoje urządzenie i Twój serwer uzgadniają klucze szyfrujące bezpośrednio między sobą. Relay przekazuje zapieczętowany ruch, do którego nie ma kluczy — nie może odczytać Twojego kodu, promptów ani haseł.
+- **Połączyć się mogą tylko Twoje urządzenia.** Urządzenie musi mieć token wydany przez *Twój* serwer w ramach [jednorazowego parowania](/pl/connect-devices/). Nikt nie odkryje Twojego serwera przez relay ani nie połączy się bez tokenu, który sam utworzyłeś — a każdy token możesz unieważnić w dowolnej chwili.
+- **Linki parowania są jednorazowe.** Kod QR do parowania działa dokładnie raz i wygasa, jeśli nie zostanie użyty, więc stary link, który wyciekł, jest bezwartościowy.
+- **Nic nie jest udostępniane, dopóki się nie zdecydujesz.** Relay pozostaje wyłączony, dopóki go nie włączysz lub nie sparujesz przez niego urządzenia, i możesz wyłączyć go w każdej chwili — urządzenia połączone przez relay są odcinane natychmiast.
+
+## Kiedy działa
+
+Relay sam zarządza swoim cyklem życia — nie ma przełącznika, o którym trzeba pamiętać:
+
+- **Uruchamia się na żądanie.** Utworzenie parowania **Wszędzie** włącza relay, a po restarcie wraca on tak długo, jak długo korzysta z niego jakiekolwiek sparowane urządzenie.
+- **Zatrzymuje się sam.** Gdy żadne urządzenie ani oczekujące parowanie nie używa relaya — na przykład po unieważnieniu ostatniego sparowanego przez relay urządzenia — wyłącza się automatycznie.
+
+**Settings → Remote Instances → OpenChamber Relay** pokazuje bieżący stan (Połączono, Ponowne łączenie, …) oraz liczbę aktualnie połączonych przez relay urządzeń. Możesz tam też nacisnąć **Wyłącz**, aby natychmiast odciąć dostęp przez relay; urządzenia w Twojej sieci lokalnej pozostają bez zmian.
+
+## Relay czy tunel?
+
+- Użyj **relaya**, aby docierać do własnego serwera z własnych sparowanych urządzeń. Zero konfiguracji i nic nie jest wystawione publicznie.
+- Użyj [tunelu](/pl/tunnels/), gdy potrzebujesz zwykłego **publicznego adresu URL** — na przykład by otworzyć OpenChamber w zwykłej przeglądarce na maszynie, której nie możesz sparować, albo udostępnić dostęp za [hasłem UI](/pl/security/).
+
+## Powiązane
+
+- [Połącz urządzenie](/pl/connect-devices/) — sparuj urządzenie jednorazowym kodem QR
+- [Aplikacje mobilne](/pl/mobile/) — zainstaluj aplikację na iOS lub Androida
+- [Bezpieczeństwo](/pl/security/) — hasła, klucze dostępu i podstawy udostępniania
+- [Dostęp zdalny](/pl/troubleshooting/remote-access/) — gdy połączenie nie chce się nawiązać
@@ -24,9 +24,13 @@ OpenChamber przeprowadza przez kolejne kroki — sprawdzenie połączenia, skonf

 Sam decydujesz, czy zapisać hasła SSH i UI, czy wpisywać je za każdym razem. Jeśli połączenie zostanie zerwane, OpenChamber zgłasza, który krok zawiódł, byś mógł to naprawić — zobacz [Dostęp zdalny](/pl/troubleshooting/remote-access/).

-## Bezpośrednie linki połączenia
+## Linki połączenia

-Jeśli zdalna maszyna już uruchamia OpenChamber, utwórz tam link połączenia i zaimportuj go w **Settings → Remote Instances → Server links**:
+Jeśli zdalna maszyna już uruchamia OpenChamber, najprostszym sposobem połączenia aplikacji desktopowej jest link parowania. W UI zdalnego serwera otwórz **Settings → Remote Instances → Połącz z tym serwerem → Dodaj urządzenie**, utwórz link i zaimportuj go na swoim komputerze w **Settings → Remote Instances → Inne serwery OpenChamber → Importuj link**. Pełny opis znajdziesz w [Połącz urządzenie](/pl/connect-devices/).
+
+Link utworzony z opcją **Wszędzie** zawiera zarówno adres bezpośredni, jak i trasę przez [Private Relay](/pl/private-relay/): aplikacja desktopowa łączy się bezpośrednio, gdy może dotrzeć do serwera (ta sama sieć), a poza domem przełącza się na szyfrowany end-to-end relay. Status obok każdego zapisanego serwera pokazuje, która trasa jest używana.
+
+Link możesz też utworzyć z terminala na zdalnej maszynie:

 ```bash
 openchamber connect-url --port 3000 --server http://your-host:3000 --qr
@@ -34,9 +38,11 @@ openchamber connect-url --port 3000 --server http://your-host:3000 --qr

 `connect-url` najpierw uruchamia serwer, jeśli nic nie działa na tym porcie. Dodaj `--api-only` dla serwera headless, `--lan` aby nasłuchiwać w LAN przy starcie, `--ui-password` aby chronić dostęp z przeglądarki oraz `--name` aby nazwać zapisane połączenie.

-Wygenerowany link zawiera token klienta dla aplikacji OpenChamber. Ten token jest osobny od hasła UI w przeglądarce i przetrwa restarty, dopóki go nie unieważnisz lub usuniesz.
+Wygenerowany link zawiera jednorazowy sekret parowania. Po zaimportowaniu urządzenie ma własny token klienta — osobny od hasła UI w przeglądarce — który przetrwa restarty serwera, dopóki nie unieważnisz go na serwerze, który go wydał.

 ## Powiązane

+- [Połącz urządzenie](/pl/connect-devices/) — linki parowania, kody QR i zarządzanie urządzeniami
+- [Private Relay](/pl/private-relay/) — jak działają połączenia „Wszędzie"
 - [OpenCode Server](/pl/opencode-server/) — połącz się ze zdalnym serwerem w wersji webowej lub VS Code
 - [Dostęp zdalny](/pl/troubleshooting/remote-access/) — gdy połączenie nie chce się nawiązać
@@ -25,13 +25,20 @@ Po ustawieniu hasła możesz dodać klucze dostępu (Face ID, Touch ID, klucz be

 Klucze dostępu są powiązane z bieżącym hasłem. Jeśli zmienisz lub usuniesz hasło, zapisane klucze dostępu zostaną wyczyszczone i będziesz je dodawać ponownie.

+## Tokeny urządzeń
+
+Urządzenia sparowane przez [Połącz urządzenie](/pl/connect-devices/) uwierzytelniają się własnymi tokenami per urządzenie, a nie hasłem UI. Linki parowania są jednorazowe i wygasają, jeśli nie zostaną użyte; każde sparowane urządzenie jest widoczne w **Settings → Remote Instances → Połącz z tym serwerem**, gdzie w każdej chwili możesz unieważnić dowolne z nich. Połączenia spoza domu przechodzą przez [Private Relay](/pl/private-relay/), który jest szyfrowany end-to-end i nie może odczytać Twojego ruchu.
+
 ## Zanim ją udostępnisz

 - Domyślnie OpenChamber nasłuchuje tylko na Twojej własnej maszynie (`127.0.0.1`). Nasłuchiwanie szerzej wymaga celowej zmiany i najpierw powinieneś ustawić hasło.
- Preferuj [tunel](/pl/tunnels/) lub sieć prywatną (jak VPN) zamiast otwierania portu do internetu.
+- Dla własnych urządzeń preferuj [parowanie](/pl/connect-devices/) z [Private Relay](/pl/private-relay/) — nic nie jest wtedy wystawione publicznie.
+- Jeśli potrzebujesz publicznego adresu URL, preferuj [tunel](/pl/tunnels/) lub sieć prywatną (jak VPN) zamiast otwierania portu do internetu.
 - Jeśli umieszczasz OpenChamber za własnym serwerem HTTPS, zobacz [Reverse Proxy](/pl/reverse-proxy/).

 ## Powiązane

- [Tunele](/pl/tunnels/) — zalecany sposób na zdalne dotarcie do instancji
+- [Połącz urządzenie](/pl/connect-devices/) — jednorazowe parowanie i tokeny per urządzenie
+- [Private Relay](/pl/private-relay/) — szyfrowany end-to-end dostęp z dowolnego miejsca
+- [Tunele](/pl/tunnels/) — udostępnij publiczny URL, gdy go potrzebujesz
 - [Reverse Proxy](/pl/reverse-proxy/) — uruchom OpenChamber za własnym serwerem
@@ -12,6 +12,15 @@ Gdy nie możesz dotrzeć do OpenChamber z telefonu lub innej maszyny, rozwiązan
 - najpierw otwórz `http://localhost:3000` na tym samym komputerze — jeśli to zawiedzie, to nie jest problem zdalny; zobacz [Połączenie z OpenCode](/pl/troubleshooting/opencode-connection/)
 - potwierdź, że serwer działa, za pomocą `openchamber status`

+## Sparowane urządzenie nie chce się połączyć
+
+- kod QR / link parowania jest **jednorazowy** — jeśli został już zeskanowany (lub wygasł), utwórz nowy przez **Dodaj urządzenie**
+- jeśli urządzenie sparowano z opcją **Tylko sieć domowa**, nie połączy się spoza tej sieci — sparuj je ponownie z opcją **Wszędzie**
+- przy parowaniu **Wszędzie** sprawdź **Settings → Remote Instances → OpenChamber Relay** na serwerze: status powinien brzmieć **Połączono**; jeśli nie, wyłącz i włącz relay ponownie
+- jeśli urządzenie zostało **unieważnione**, jego token przepadł bezpowrotnie — sparuj je ponownie nowym kodem QR
+
+Zobacz [Połącz urządzenie](/pl/connect-devices/) i [Private Relay](/pl/private-relay/), aby dowiedzieć się, jak działają te połączenia.
+
 ## Link tunelu nie działa

 - uruchom `openchamber tunnel status --all`
@@ -34,5 +43,5 @@ Jeśli umieściłeś OpenChamber za reverse proxy i ładuje się dziwnie lub nie

 ## Powiązane

- [Tunele](/pl/tunnels/) · [Zdalne instancje](/pl/remote-instances/) · [Reverse Proxy](/pl/reverse-proxy/)
+- [Połącz urządzenie](/pl/connect-devices/) · [Private Relay](/pl/private-relay/) · [Tunele](/pl/tunnels/) · [Zdalne instancje](/pl/remote-instances/) · [Reverse Proxy](/pl/reverse-proxy/)
 - [Bezpieczeństwo](/pl/security/) — zabezpiecz UI przed udostępnieniem
@@ -5,7 +5,9 @@ description: Bezpiecznie udostępnij OpenChamber do dostępu zdalnego i mobilneg

 # Tunele

-Tunel to publiczny link do Twojego OpenChamber, dzięki któremu możesz dotrzeć do niego z telefonu lub z innej sieci. Użyj `openchamber tunnel`, aby utworzyć go dla działającej instancji.
+Tunel to publiczny link do Twojego OpenChamber, dzięki któremu możesz dotrzeć do niego ze zwykłej przeglądarki w innej sieci. Użyj `openchamber tunnel`, aby utworzyć go dla działającej instancji.
+
+> Łączenie **własnych urządzeń** (aplikacja mobilna, drugi komputer) zwykle nie wymaga tunelu — zamiast tego [sparuj je](/pl/connect-devices/) i pozwól, by szyfrowany end-to-end [Private Relay](/pl/private-relay/) zajął się dostępem spoza domu bez żadnej konfiguracji.

 ## Wymagania wstępne

@@ -111,6 +113,7 @@ openchamber tunnel stop --port 3000

 ## Powiązane

+- [Połącz urządzenie](/pl/connect-devices/) — sparuj własne urządzenia bez publicznego adresu URL
 - [Bezpieczeństwo](/pl/security/) — zabezpiecz interfejs przed udostępnieniem
 - [Tunele w aplikacji desktopowej](/pl/desktop-tunnels/) — konfiguracja tunelu w aplikacji desktopowej bez startu z CLI
 - [PWA i dostęp z telefonu](/pl/mobile/) — korzystaj z OpenChamber z telefonu