Conéctate a tu box por SSH

Cada box acepta SSH en ssh <box>@ssh.detachbox.com con las claves de tu cuenta. Añade una clave una vez y todos tus boxes la dejan entrar. La redirección de puertos, rsync y Remote-SSH de VS Code o Cursor funcionan con la misma dirección.

Añade tu clave SSH

Los boxes solo dejan entrar con claves, sin contraseñas.

1. En tu ordenador, muestra tu clave pública:

   cat ~/.ssh/id_ed25519.pub
   

   ¿Aún no tienes clave? Crea una con ssh-keygen -t ed25519.

2. En el panel, abre Claves SSH y elige Añadir clave SSH.

3. Pega la línea entera. Empieza por ssh-ed25519, ssh-rsa o ecdsa-sha2.

4. Ponle nombre a la clave, por ejemplo portátil. Deja el nombre vacío para usar el comentario de la clave.

5. Elige Añadir clave SSH.

Cada clave de tu cuenta abre todos tus boxes, y cada box la recoge solo. Una cuenta admite hasta 50 claves.

Pega solo el archivo .pub. El panel rechaza una clave privada, y la mitad privada nunca sale de tu portátil.

Importa tus claves desde GitHub

1. En Claves SSH, elige Importar desde GitHub.
2. Escribe tu usuario de GitHub.
3. Elige Importar claves.

El panel toma todas las claves públicas listadas en github.com/<username>.keys. Las claves que ya están en tu cuenta se saltan.

Conéctate a un box

Copia el comando de Conéctate por SSH, en el Resumen del box, y ejecútalo:

ssh [email protected]

Entras en el box como el usuario dev. Para no escribir la dirección, añade el box a ~/.ssh/config:

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

A partir de ahí, ssh my-box conecta.

Verifica la clave del host

En la primera conexión, SSH te pregunta si confías en el host. Abre Verificar la clave del host en Conéctate por SSH y compara la huella que aparece ahí con la que muestra SSH. Responde yes solo si coinciden.

Únete a tus pestañas de terminal por SSH

Cada pestaña del navegador es una sesión tmux en el box, así que SSH llega a las mismas sesiones:

tmux ls
tmux attach -t <session>

Sal con Ctrl+B y después D. El agente sigue trabajando.

Ejecuta un comando en el box

ssh [email protected] 'docker ps'

Las variables DETACHBOX_* de box.env también se cargan en estos shells. Agentes las lista.

Redirige un servidor de desarrollo o una base de datos

Redirige un puerto a tu ordenador con -L:

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

Abre localhost:3000 en tu portátil para ver la app que corre dentro del box. La página del box tiene este comando en Redirige un servidor de desarrollo.

Para una base de datos o cualquier puerto TCP sin HTTP, redirige sin shell:

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

Para apps web, una URL de vista previa no necesita túnel y también se abre en tu teléfono.

Copia una carpeta con rsync

La terminal del navegador no acepta carpetas. Copia una carpeta con rsync:

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

Intercambia las dos rutas para copiar del box a tu ordenador.

Abre el box en VS Code o Cursor

Los dos editores se conectan con su extensión Remote-SSH, con tu propia clave.

1. Añade tu clave en Claves SSH.
2. En el editor, conéctate al host [email protected].

Desde la terminal del navegador, abre una ruta de archivo en el visor y elige Abrir en VS Code o Abrir en Cursor. El editor abre ese archivo en esa línea por Remote-SSH. Si no logra conectar, añade tu clave en Claves SSH.

Quita una clave

1. En Claves SSH, abre el menú de la clave y elige Eliminar clave.
2. Confirma.

Todos los boxes dejan de aceptar la clave. Si eliminas tu única clave, SSH queda cerrado hasta que añadas otra. La terminal del navegador sigue funcionando.

¿Permission denied?

Permission denied (publickey) significa que el box no recibió ninguna clave que conozca. Comprueba que la clave de tu ordenador sea una de las listadas en Claves SSH y que el usuario del comando sea el nombre del box. Solución de problemas tiene más soluciones.