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
5.8 KiB
Plaintext
98 lines
5.8 KiB
Plaintext
---
|
||
title: OpenCode Server
|
||
description: Підключіть OpenChamber до локального або віддаленого сервера OpenCode.
|
||
---
|
||
|
||
# OpenCode Server
|
||
|
||
OpenChamber працює поверх сервера OpenCode. За замовчуванням він сам запускає такий сервер, тож вам нічого робити не доводиться. Ця сторінка потрібна лише тоді, коли ви хочете спрямувати OpenChamber на сервер, який ви вже запускаєте, або керувати тим, що він запускає.
|
||
|
||
## Як OpenChamber знаходить сервер
|
||
|
||
Коли OpenChamber стартує, він шукає сервер у такому порядку:
|
||
|
||
1. повторно використовує сервер, який уже запустив
|
||
2. підключається до зовнішнього, якщо ви це налаштували (див. нижче)
|
||
3. автоматично виявляє сервер на стандартному порту (`4096`)
|
||
4. інакше — запускає й керує власним
|
||
|
||
Якщо нічого не налаштовано, крок 4 відбувається автоматично, і все працює.
|
||
|
||
## Підключення до сервера, який ви вже запускаєте
|
||
|
||
Задайте це перед запуском OpenChamber:
|
||
|
||
```bash
|
||
OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber
|
||
```
|
||
|
||
- `OPENCODE_HOST` — повна адреса вашого сервера OpenCode, разом із портом (значення на кшталт `http://localhost:4096`). У кінці не повинно бути шляху.
|
||
- `OPENCODE_SKIP_START=true` — каже OpenChamber не запускати власний сервер.
|
||
|
||
Якщо вам потрібно лише змінити порт, задайте `OPENCODE_PORT` замість `OPENCODE_HOST`.
|
||
|
||
Якщо в `OPENCODE_HOST` бракує порту або є шлях, OpenChamber ігнорує його й повертається до запуску власного сервера. Слідкуйте за журналами запуску на предмет попередження `[config]`, якщо очікуване підключення не відбулося.
|
||
|
||
## Керування сервером із CLI
|
||
|
||
```bash
|
||
openchamber status
|
||
openchamber logs
|
||
openchamber restart
|
||
openchamber stop
|
||
```
|
||
|
||
`openchamber` сам по собі запускає сервер у фоні. Додайте `--foreground`, щоб лишити його прив'язаним до вашого терміналу.
|
||
|
||
## Запуск OpenChamber при вході в систему
|
||
|
||
Скористайтеся `startup enable`, щоб встановити нативний користувацький сервіс. OpenChamber використовує `launchd` на macOS, `systemd --user` на Linux і Task Scheduler на Windows.
|
||
|
||
```bash
|
||
openchamber startup enable
|
||
openchamber startup status
|
||
openchamber startup disable
|
||
```
|
||
|
||
Щоб захистити UI, задайте пароль під час увімкнення сервісу:
|
||
|
||
```bash
|
||
OPENCHAMBER_UI_PASSWORD='secret' openchamber startup enable
|
||
```
|
||
|
||
Для headless-сервера, який стартує під час входу та використовується desktop або mobile застосунками, додайте `--api-only` і доступний host:
|
||
|
||
```bash
|
||
openchamber startup enable --port 3000 --api-only --host 0.0.0.0 --ui-password secret
|
||
```
|
||
|
||
`startup enable` зберігає знімок поточного середовища в сервісі, щоб запуск був ближчим до ручного запуску `openchamber` з тієї самої shell-сесії. Так зберігаються токени провайдерів, `PATH`, налаштування SSH agent та інші CLI-змінні для auth/config. Використайте `--no-env-snapshot`, якщо потрібне мінімальне середовище сервісу.
|
||
|
||
Startup-сервіс пам'ятає `--port`, `--host`, `--ui-password` і `--api-only`. CLI restart і restart під час оновлення повторно використовують ці збережені налаштування.
|
||
|
||
Щоб створити link підключення для іншого застосунку OpenChamber, використайте:
|
||
|
||
```bash
|
||
openchamber connect-url --port 3000 --server http://your-host:3000 --qr
|
||
```
|
||
|
||
Запустіть `openchamber connect-url --help`, щоб побачити всі опції link, зокрема `--name`, `--lan`, `--server`, `--api-only`, `--ui-password` і `--qr`.
|
||
|
||
Тунелями для такого запущеного сервісу можна керувати окремо:
|
||
|
||
```bash
|
||
openchamber tunnel start --port 3000
|
||
openchamber tunnel stop --port 3000
|
||
```
|
||
|
||
Зупинка тунелю не перезапускає сервіс або застосунок.
|
||
|
||
## «OpenCode перезапускається»
|
||
|
||
Поки сервер запускається або перезапускається, OpenChamber показує стан «OpenCode перезапускається» і призупиняє запити, доки той не буде готовий. Це нормально одразу після запуску чи перезапуску. Якщо стан так і не зникає, див. [Підключення до OpenCode](/uk/troubleshooting/opencode-connection/).
|
||
|
||
## Пов'язане
|
||
|
||
- [Провайдери, моделі та агенти](/uk/providers/) — налаштуйте, із чим спілкується сервер
|
||
- [Підключення до OpenCode](/uk/troubleshooting/opencode-connection/) — якщо не вдається підключитися
|