SSH Remoto

O Maestri suporta conexão a servidores remotos via SSH, habilitando comunicação inter-agentes entre máquinas ou ambientes isolados.

Habilitando SSH

  1. Vá em Configurações > Geral > SSH Remoto.
  2. Clique em Configurar.
  3. Ative Habilitar workspaces SSH.
  4. Opcionalmente ajuste a Porta do Túnel (padrão: 7433).

Como funciona

Quando você se conecta a um workspace SSH, o Maestri instala um pequeno script no servidor remoto e abre um túnel reverso para que os agentes possam se comunicar de volta.

O script é um simples wrapper de curl — você pode inspecioná-lo a qualquer momento. Nenhum processo em background é instalado.

Configurações por conexão

Ao configurar SSH para um workspace ou terminal, você pode personalizar:

  • Host — hostname ou endereço IP
  • Usuário — nome de usuário SSH
  • Porta — porta SSH (padrão: 22)
  • Caminho do Script — onde o script maestri é instalado (padrão: ~/.local/bin/maestri)
  • Adicionar ao PATH — se deve adicionar o diretório do script ao seu perfil de shell

Compartilhando arquivos com o agente remoto

Arrastar uma imagem para um terminal SSH — ou colar uma da área de transferência — normalmente só colaria o caminho local do arquivo no Mac, o que não tem sentido na máquina remota. O Maestri intercepta isso: os bytes da imagem são enviados para /tmp/maestri-drops na máquina remota e é o caminho remoto que vai parar no prompt, então o agente consegue de fato ler o arquivo.

Arquivos em /tmp/maestri-drops com mais de 60 minutos são removidos a cada novo upload, então o diretório de staging não cresce sem limite.

Notas de segurança

  • Usa suas chaves SSH existentes de ~/.ssh
  • O túnel só faz bind ao localhost — acesso remoto requer a conexão SSH
  • Chaves de host pela primeira vez são aceitas automaticamente; chaves alteradas disparam um aviso