Conecte-se ao seu box por SSH

Todo box aceita SSH em ssh <box>@ssh.detachbox.com com as chaves da sua conta. Adicione uma chave uma vez e todos os seus boxes passam a aceitá-la. Encaminhamento de portas, rsync e o Remote-SSH do VS Code ou do Cursor funcionam pelo mesmo endereço.

Adicione sua chave SSH

Os boxes só aceitam chaves, nunca senhas.

1. No seu computador, mostre a sua chave pública:

   cat ~/.ssh/id_ed25519.pub
   

   Ainda não tem uma chave? Crie com ssh-keygen -t ed25519.

2. No painel, abra Chaves SSH e escolha Adicionar chave SSH.

3. Cole a linha inteira. Ela começa com ssh-ed25519, ssh-rsa ou ecdsa-sha2.

4. Dê um nome à chave, por exemplo notebook. Deixe o nome vazio para usar o comentário da chave.

5. Escolha Adicionar chave SSH.

Cada chave da sua conta abre todos os seus boxes, e cada box pega a chave sozinho. Uma conta guarda até 50 chaves.

Cole só o arquivo .pub. O painel recusa uma chave privada, e a metade privada nunca sai do seu notebook.

Importe suas chaves do GitHub

1. Em Chaves SSH, escolha Importar do GitHub.
2. Digite seu nome de usuário do GitHub.
3. Escolha Importar chaves.

O painel pega todas as chaves públicas listadas em github.com/<username>.keys. As chaves que já estão na sua conta são ignoradas.

Conecte-se a um box

Copie o comando de Conectar por SSH, em Visão geral do box, e rode:

ssh [email protected]

Você entra no box como o usuário dev. Para não digitar o endereço, adicione o box ao ~/.ssh/config:

Host my-box
  HostName ssh.detachbox.com
  User my-box

Depois disso, ssh my-box conecta.

Verifique a chave do host

Na primeira conexão, o SSH pede para você confiar no host. Abra Verificar a chave do host em Conectar por SSH e compare a impressão digital mostrada ali com a que o SSH exibe. Responda yes só quando as duas baterem.

Entre nas suas abas de terminal por SSH

Cada aba do navegador é uma sessão tmux no box, então o SSH alcança as mesmas sessões:

tmux ls
tmux attach -t <session>

Saia da sessão com Ctrl+B e depois D. O agente continua trabalhando.

Rode um comando no box

ssh [email protected] 'docker ps'

As variáveis DETACHBOX_* do box.env também carregam nesses shells. Agentes lista todas.

Encaminhe um servidor de desenvolvimento ou um banco de dados

Encaminhe uma porta para o seu computador com -L:

ssh -L 3000:localhost:3000 [email protected]

Abra localhost:3000 no notebook para ver o app rodando dentro do box. A página do box tem esse comando em Redirecionar um servidor de dev.

Para um banco de dados ou qualquer porta TCP pura, encaminhe sem shell:

ssh -N -L 5432:localhost:5432 [email protected]

Para apps web, uma URL de preview dispensa o túnel e abre no celular também.

Copie uma pasta com rsync

O terminal do navegador recusa pastas. Copie uma pasta com rsync:

rsync -az ./my-folder/ [email protected]:~/my-folder/

Inverta os dois caminhos para copiar do box para o seu computador.

Abra o box no VS Code ou no Cursor

Os dois editores conectam pela extensão Remote-SSH, com a sua própria chave.

1. Adicione sua chave em Chaves SSH.
2. No editor, conecte ao host [email protected].

No terminal do navegador, abra um caminho de arquivo no visualizador e escolha Abrir no VS Code ou Abrir no Cursor. O editor abre aquele arquivo naquela linha pelo Remote-SSH. Se ele não conseguir conectar, adicione sua chave em Chaves SSH.

Remova uma chave

1. Em Chaves SSH, abra o menu da chave e escolha Excluir chave.
2. Confirme.

Todos os boxes deixam de aceitar a chave. Excluir a sua única chave trava o SSH até você adicionar outra. O terminal do navegador continua funcionando.

Permission denied?

Permission denied (publickey) quer dizer que o box não recebeu uma chave que ele conhece. Confira se a chave no seu computador está listada em Chaves SSH e se o usuário no comando é o nome do box. Solução de problemas traz mais soluções.