Bohdan Triapitsyn
2031e3b4a8
Add a packaged-client runtime boundary so the shared UI can talk to local, desktop, remote, and VS Code runtimes through the right transport instead of assuming one same-origin web server. Centralize OpenChamber-owned API access behind RuntimeAPIs, runtimeFetch, and runtime URL helpers, while keeping official OpenCode traffic on the SDK path. Support runtime switching, remote host selection, desktop client credentials, and headless connection links for pairing packaged clients with remote OpenChamber servers. Harden the new auth model by moving long-lived client tokens out of browser URLs, introducing short-lived scoped URL tokens for browser-owned transports, restricting URL-token access to explicit readable/realtime routes, and making client-token management session-scoped or self-scoped as appropriate. Update browser-owned assets and preview proxy flows to work with the split runtime model, including authenticated project icons, preview token propagation, CSP-safe preview bridge injection, and preview proxy auth that survives short-lived URL-token expiry. Tighten Electron security boundaries for packaged clients by gating privileged preload state to trusted origins and requiring explicit confirmation before connect deep-links import or switch remote runtimes. Also refresh agent guidance and project skills so future runtime/API, auth, preview, UI, CLI, settings, locale, and drag-to-reorder work follows the new architecture.
98 lines
4.0 KiB
Plaintext
98 lines
4.0 KiB
Plaintext
---
|
|
title: OpenCode Server
|
|
description: Połącz OpenChamber z lokalnym lub zdalnym serwerem OpenCode.
|
|
---
|
|
|
|
# OpenCode Server
|
|
|
|
OpenChamber działa na bazie serwera OpenCode. Domyślnie uruchamia go za Ciebie, więc nie musisz robić nic dodatkowego. Ta strona jest potrzebna tylko wtedy, gdy chcesz wskazać OpenChamber serwer, który już uruchamiasz, albo zarządzać tym, który sam startuje.
|
|
|
|
## Jak OpenChamber znajduje serwer
|
|
|
|
Gdy OpenChamber się uruchamia, szuka serwera w tej kolejności:
|
|
|
|
1. ponownie używa serwera, który już uruchomił
|
|
2. łączy się z zewnętrznym, jeśli mu to wskazałeś (zobacz niżej)
|
|
3. automatycznie wykrywa serwer na domyślnym porcie (`4096`)
|
|
4. w przeciwnym razie uruchamia i obsługuje własny
|
|
|
|
Jeśli nic nie jest skonfigurowane, krok 4 dzieje się automatycznie i od razu możesz pracować.
|
|
|
|
## Połącz się z serwerem, który już uruchamiasz
|
|
|
|
Ustaw te wartości przed uruchomieniem OpenChamber:
|
|
|
|
```bash
|
|
OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber
|
|
```
|
|
|
|
- `OPENCODE_HOST` — pełny adres Twojego serwera OpenCode, wraz z portem (wartość taka jak `http://localhost:4096`). Nie może zawierać ścieżki na końcu.
|
|
- `OPENCODE_SKIP_START=true` — informuje OpenChamber, aby nie uruchamiał własnego serwera.
|
|
|
|
Jeśli chcesz zmienić tylko port, ustaw `OPENCODE_PORT` zamiast `OPENCODE_HOST`.
|
|
|
|
Jeśli w `OPENCODE_HOST` brakuje portu lub zawiera ścieżkę, OpenChamber go zignoruje i wróci do uruchamiania własnego serwera. Obserwuj logi startowe pod kątem ostrzeżenia `[config]`, jeśli oczekiwane połączenie nie nastąpiło.
|
|
|
|
## Zarządzaj serwerem z poziomu CLI
|
|
|
|
```bash
|
|
openchamber status
|
|
openchamber logs
|
|
openchamber restart
|
|
openchamber stop
|
|
```
|
|
|
|
Samo `openchamber` uruchamia serwer w tle. Dodaj `--foreground`, aby pozostał dołączony do Twojego terminala.
|
|
|
|
## Uruchamianie OpenChamber po zalogowaniu
|
|
|
|
Użyj `startup enable`, aby zainstalować natywną usługę użytkownika. OpenChamber używa `launchd` na macOS, `systemd --user` na Linuksie i Harmonogramu zadań w Windows.
|
|
|
|
```bash
|
|
openchamber startup enable
|
|
openchamber startup status
|
|
openchamber startup disable
|
|
```
|
|
|
|
Aby zabezpieczyć UI, ustaw hasło podczas włączania usługi:
|
|
|
|
```bash
|
|
OPENCHAMBER_UI_PASSWORD='secret' openchamber startup enable
|
|
```
|
|
|
|
Dla serwera headless uruchamianego przy logowaniu i używanego przez aplikacje desktopowe lub mobilne dodaj `--api-only` oraz osiągalny host:
|
|
|
|
```bash
|
|
openchamber startup enable --port 3000 --api-only --host 0.0.0.0 --ui-password secret
|
|
```
|
|
|
|
`startup enable` zapisuje migawkę bieżącego środowiska w usłudze, aby uruchomienie było bliższe ręcznemu startowi `openchamber` z tej samej powłoki. Zachowuje to tokeny dostawców, `PATH`, ustawienia agenta SSH i inne zmienne CLI auth/config. Użyj `--no-env-snapshot`, jeśli chcesz minimalne środowisko usługi.
|
|
|
|
Usługa startowa pamięta `--port`, `--host`, `--ui-password` i `--api-only`. Restart z CLI oraz restart podczas aktualizacji używają tych zapisanych ustawień.
|
|
|
|
Aby utworzyć link połączenia dla innej aplikacji OpenChamber, użyj:
|
|
|
|
```bash
|
|
openchamber connect-url --port 3000 --server http://your-host:3000 --qr
|
|
```
|
|
|
|
Uruchom `openchamber connect-url --help`, aby zobaczyć wszystkie opcje linku, w tym `--name`, `--lan`, `--server`, `--api-only`, `--ui-password` i `--qr`.
|
|
|
|
Tunelami dla tej działającej usługi możesz zarządzać niezależnie:
|
|
|
|
```bash
|
|
openchamber tunnel start --port 3000
|
|
openchamber tunnel stop --port 3000
|
|
```
|
|
|
|
Zatrzymanie tunelu nie restartuje usługi ani aplikacji.
|
|
|
|
## „OpenCode uruchamia się ponownie”
|
|
|
|
Gdy serwer startuje lub uruchamia się ponownie, OpenChamber pokazuje stan „OpenCode uruchamia się ponownie” i wstrzymuje żądania, aż będzie gotowy. To normalne tuż po uruchomieniu lub restarcie. Jeśli ten stan nigdy nie znika, zobacz [Połączenie z OpenCode](/pl/troubleshooting/opencode-connection/).
|
|
|
|
## Powiązane
|
|
|
|
- [Dostawcy, modele i agenci](/pl/providers/) — skonfiguruj to, z czym serwer się komunikuje
|
|
- [Połączenie z OpenCode](/pl/troubleshooting/opencode-connection/) — jeśli nie chce się połączyć
|