Zdalne instancje

Aplikacja na komputerze może połączyć się z OpenChamber działającym na innej maszynie przez SSH — serwer służbowy, maszyna w chmurze, homelab — i przenieść jego UI na Twój ekran, jakby był lokalny. Skonfiguruj to w Settings → Remote Instances.

Zdalne instancje to funkcja tylko na komputerze. W wersji webowej lub w VS Code połącz się ze zdalnym serwerem za pomocą zmiennych środowiskowych z OpenCode Server.

Dodaj zdalną instancję

1. Otwórz Settings → Remote Instances i dodaj jedną.
2. Podaj polecenie SSH, którego normalnie używasz, by dotrzeć do maszyny, oraz przydomek.
3. Wybierz, jak OpenChamber tam działa:
   • managed — OpenChamber instaluje i uruchamia się sam na zdalnej maszynie
   • external — połącz się z tym, który już działa
4. Połącz.

OpenChamber przeprowadza przez kolejne kroki — sprawdzenie połączenia, skonfigurowanie zdalnej maszyny, uruchomienie serwera i przekazanie portu — i pokazuje, na jakim etapie się znajduje. Gdy osiągnie stan ready, zdalne UI ładuje się lokalnie.

Poświadczenia

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.

Linki połączenia

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.

Link utworzony z opcją Wszędzie zawiera zarówno adres bezpośredni, jak i trasę przez 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:

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. Dodaj --relay, aby link działał także poza siecią lokalną: urządzenie preferuje połączenie bezpośrednie, gdy serwer jest osiągalny, a w przeciwnym razie przełącza się na Private Relay — instancja sama uruchomi relay.

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 — linki parowania, kody QR i zarządzanie urządzeniami
• Private Relay — jak działają połączenia „Wszędzie”
• OpenCode Server — połącz się ze zdalnym serwerem w wersji webowej lub VS Code
• Dostęp zdalny — gdy połączenie nie chce się nawiązać