Pular para o conteúdo
OpenChamber

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 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.

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 para o fluxo completo.

Um link criado com Em qualquer lugar carrega tanto um endereço direto quanto uma rota pelo 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:

Terminal window
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 — 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