Bohdan Triapitsyn
6ec1797583
- --relay links now carry both routes: direct LAN plus relay fallback, matching the UI's Anywhere pairing; devices prefer the direct route - pairing sessions created by the CLI are marked with usesRelay, and the server reconciles relay demand on a timer, so a headless instance brings the relay up on its own after connect-url --relay - warn with LAN_UNREACHABLE when the link's direct route points at loopback and other devices cannot use it - document the --relay flow and the --lan binding caveat in Connect a Device and Remote Instances across all locales
49 lines
3.6 KiB
Plaintext
49 lines
3.6 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
|
|
|
|
Se uma máquina remota já executa OpenChamber, a forma mais fácil de conectar o app de desktop é um link de pareamento. Na UI do servidor remoto, abra **Settings → Remote Instances → Conectar a este servidor → Adicionar um dispositivo**, crie um link e importe-o no seu desktop em **Settings → Remote Instances → Outros servidores OpenChamber → Importar link**. Veja [Conectar um Dispositivo](/pt-br/connect-devices/) para o fluxo completo.
|
|
|
|
Um link criado com **Em qualquer lugar** carrega tanto um endereço direto quanto uma rota pelo [Private Relay](/pt-br/private-relay/): o desktop conecta diretamente quando consegue alcançar o servidor (mesma rede) e recorre ao relay criptografado de ponta a ponta quando você está fora. O status ao lado de cada servidor salvo mostra qual rota está em uso.
|
|
|
|
Você também pode criar um link a partir de um terminal na máquina remota:
|
|
|
|
```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. Adicione `--relay` para um link que também funciona fora da rede local: o dispositivo prefere a conexão direta quando alcançável e recorre ao [Private Relay](/pt-br/private-relay/) — a instância liga o relay sozinha.
|
|
|
|
O link gerado contém um segredo de pareamento de uso único. Depois de importado, o dispositivo passa a ter o próprio token de cliente — separado da senha de UI do navegador — que sobrevive a reinícios do servidor até você revogá-lo no servidor emissor.
|
|
|
|
## Relacionado
|
|
|
|
- [Conectar um Dispositivo](/pt-br/connect-devices/) — links de pareamento, códigos QR e gerenciamento de dispositivos
|
|
- [Private Relay](/pt-br/private-relay/) — como funcionam as conexões "Em qualquer lugar"
|
|
- [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
|