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
2.3 KiB
Plaintext
43 lines
2.3 KiB
Plaintext
---
|
|
title: Instâncias Remotas
|
|
description: Conecte o app de desktop ao OpenChamber em outra máquina via SSH.
|
|
---
|
|
|
|
# Instâncias Remotas
|
|
|
|
O app de desktop pode conectar ao OpenChamber rodando em outra máquina via SSH — um servidor de trabalho, uma máquina na nuvem, um homelab — e trazer a UI dela para a sua tela como se fosse local. Configure isso em **Settings → Remote Instances**.
|
|
|
|
> As instâncias remotas são um recurso **apenas para desktop**. Na web ou no VS Code, conecte a um servidor remoto com as variáveis de ambiente em [OpenCode Server](/pt-br/opencode-server/) em vez disso.
|
|
|
|
## Adicionar uma instância remota
|
|
|
|
1. Abra **Settings → Remote Instances** e adicione uma.
|
|
2. Forneça o comando SSH que você normalmente usaria para alcançar a máquina, mais um apelido.
|
|
3. Escolha como o OpenChamber roda ali:
|
|
- **managed** — o OpenChamber se instala e inicia na máquina remota
|
|
- **external** — conecte a um que já está em execução
|
|
4. Conecte.
|
|
|
|
O OpenChamber percorre as etapas — verificando a conexão, configurando o remoto, iniciando o servidor e encaminhando a porta — e mostra em que ponto está em cada estágio. Quando chega a **ready**, a UI remota carrega localmente.
|
|
|
|
## Credenciais
|
|
|
|
Você decide se quer salvar as senhas SSH e de UI ou inseri-las a cada vez. Se a conexão cair, o OpenChamber informa qual etapa falhou para você corrigi-la — veja [Acesso remoto](/pt-br/troubleshooting/remote-access/).
|
|
|
|
## Links de conexão direta
|
|
|
|
Se uma máquina remota já executa OpenChamber, crie um link de conexão nela e importe em **Settings → Remote Instances → Server links**:
|
|
|
|
```bash
|
|
openchamber connect-url --port 3000 --server http://your-host:3000 --qr
|
|
```
|
|
|
|
`connect-url` inicia o servidor primeiro se nada estiver rodando nessa porta. Adicione `--api-only` para um servidor headless, `--lan` para escutar na LAN ao iniciar, `--ui-password` para proteger o acesso pelo navegador e `--name` para nomear a conexão salva.
|
|
|
|
O link gerado contém um token de cliente para apps OpenChamber. Esse token é separado da senha da UI do navegador e sobrevive a reinícios até ser revogado ou removido.
|
|
|
|
## Relacionado
|
|
|
|
- [OpenCode Server](/pt-br/opencode-server/) — conecte a um servidor remoto na web ou no VS Code
|
|
- [Acesso remoto](/pt-br/troubleshooting/remote-access/) — quando uma conexão não se completa
|