ОКАкадемия OpenChamber
← Документация

OpenCode Server

Подключение OpenChamber к локальному или удалённому серверу OpenCode.

Раздел: Начало · Статус: draft · Релиз-проверка: v1.18.2

OpenCode Server

OpenChamber работает поверх сервера OpenCode. По умолчанию он запускает его сам, так что вам ничего делать не нужно. Эта страница нужна только если вы хотите указать OpenChamber на уже запущенный вами сервер или управлять тем, который он поднимает.

Как OpenChamber находит сервер

При запуске OpenChamber ищет сервер в таком порядке:

  1. переиспользует сервер, который уже запустил
  2. подключается к внешнему, если вы указали его (см. ниже)
  3. автоматически обнаруживает сервер на порту по умолчанию (4096)
  4. иначе — запускает и управляет своим собственным

Если ничего не настроено, шаг 4 выполняется автоматически, и вы работаете.

Подключение к уже запущенному серверу

Задайте эти переменные перед запуском OpenChamber:

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

openchamber status
openchamber logs
openchamber restart
openchamber stop

openchamber сам по себе запускает сервер в фоне. Добавьте --foreground, чтобы держать его привязанным к вашему терминалу.

Автозапуск OpenChamber при входе в систему

Используйте startup enable, чтобы установить нативный пользовательский сервис. OpenChamber использует launchd на macOS, systemd --user на Linux и Планировщик задач на Windows.

openchamber startup enable
openchamber startup status
openchamber startup disable

Чтобы защитить UI, задайте пароль при включении сервиса:

OPENCHAMBER_UI_PASSWORD='secret' openchamber startup enable

Для headless-сервера, который стартует при входе и предназначен для десктоп- или мобильных клиентов, добавьте --api-only и доступный хост:

openchamber startup enable --port 3000 --api-only --host 0.0.0.0 --ui-password secret

startup enable снимает слепок вашего текущего окружения в сервис, чтобы он вёл себя как запуск openchamber из той же оболочки. Это сохраняет токены провайдеров, PATH, настройки SSH-агента и другие переменные CLI-авторизации/конфигурации. Используйте --no-env-snapshot, если хотите минимальное окружение сервиса.

Сервис автозапуска запоминает --port, --host, --ui-password и --api-only. Перезапуск и обновление через CLI переиспользуют сохранённые настройки.

Чтобы создать ссылку подключения для другого приложения OpenChamber:

openchamber connect-url --port 3000 --server http://your-host:3000 --qr

Выполните openchamber connect-url --help, чтобы увидеть все опции ссылки, включая --name, --lan, --server, --api-only, --ui-password и --qr.

Туннелями для запущенного сервиса можно управлять независимо:

openchamber tunnel start --port 3000
openchamber tunnel stop --port 3000

Остановка туннеля не перезапускает сервис и приложение.

«OpenCode is restarting»

Пока сервер запускается или перезапускается, OpenChamber показывает состояние «OpenCode is restarting» и приостанавливает запросы, пока сервер не будет готов. Это нормально сразу после запуска или перезапуска. Если состояние не исчезает — см. Подключение OpenCode.

Связанное