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.
43 lines
3.6 KiB
Plaintext
43 lines
3.6 KiB
Plaintext
---
|
||
title: Віддалені інстанси
|
||
description: Підключайте десктопний застосунок до OpenChamber на іншій машині через SSH.
|
||
---
|
||
|
||
# Віддалені інстанси
|
||
|
||
Десктопний застосунок може підключатися до OpenChamber, запущеного на іншій машині, через SSH — робочий сервер, хмарну машину, домашню лабораторію — і виводити її UI на ваш екран так, ніби він локальний. Налаштуйте це в **Settings → Remote Instances**.
|
||
|
||
> Віддалені інстанси — це функція **лише для десктопа**. У вебі чи у VS Code підключайтеся до віддаленого сервера за допомогою змінних середовища з [OpenCode Server](/uk/opencode-server/).
|
||
|
||
## Додавання віддаленого інстансу
|
||
|
||
1. Відкрийте **Settings → Remote Instances** і додайте один.
|
||
2. Задайте йому SSH-команду, яку ви зазвичай використовуєте, щоб дістатися машини, плюс псевдонім.
|
||
3. Виберіть, як OpenChamber запускається там:
|
||
- **managed** — OpenChamber установлює й запускає себе на віддаленій машині
|
||
- **external** — підключитися до того, що вже запущений
|
||
4. Підключіться.
|
||
|
||
OpenChamber проходить через кроки — перевірку з'єднання, налаштування віддаленої машини, запуск сервера й перенаправлення порту — і показує, на якому етапі він на кожній стадії. Коли він досягає **ready**, віддалений UI завантажується локально.
|
||
|
||
## Облікові дані
|
||
|
||
Ви вирішуєте, чи зберігати SSH- та UI-паролі, чи вводити їх щоразу. Якщо з'єднання обривається, OpenChamber повідомляє, який крок збоїв, щоб ви могли виправити — див. [Віддалений доступ](/uk/troubleshooting/remote-access/).
|
||
|
||
## Прямі link підключення
|
||
|
||
Якщо на віддаленій машині вже запущено OpenChamber, створіть там link підключення й імпортуйте його в **Settings → Remote Instances → Server links**:
|
||
|
||
```bash
|
||
openchamber connect-url --port 3000 --server http://your-host:3000 --qr
|
||
```
|
||
|
||
`connect-url` спочатку запускає сервер, якщо на цьому порту нічого не працює. Додайте `--api-only` для headless-сервера, `--lan` для LAN bind під час старту, `--ui-password` для захисту browser access і `--name` для назви збереженого підключення.
|
||
|
||
Згенерований link містить client token для застосунків OpenChamber. Цей token окремий від пароля browser UI і зберігається після рестартів, доки ви його не відкличете або не видалите.
|
||
|
||
## Пов'язане
|
||
|
||
- [OpenCode Server](/uk/opencode-server/) — підключайтеся до віддаленого сервера у вебі чи VS Code
|
||
- [Віддалений доступ](/uk/troubleshooting/remote-access/) — коли з'єднання не завершується
|