Cómo entrar por SSH a un sandbox
Cada sandbox responde a SSH en el puerto 2222 de su servidor, con el id del sandbox como nombre de usuario. Su registro trae el comando completo, ssh_command, como ssh [email protected] -p 2222.
Dos cosas te dejan entrar. Una clave pública del espacio de trabajo: agrega la tuya una vez con set_ssh_keys o en los ajustes del panel web, y abre todos los sandboxes del espacio de trabajo. O un token de conexión como contraseña, para un programa que no tiene clave: connect_sandbox crea uno para un sandbox, válido una hora por defecto y un día como máximo. pethost sandbox shell crea uno por ti e inicia sesión con él.
from pathlib import Path
from pethost.sandboxes import Sandboxes
sandboxes = Sandboxes() # lee PETHOST_TOKEN
key = Path("~/.ssh/id_ed25519.pub").expanduser().read_text()
sandboxes.set_ssh_keys(ssh_keys=[key]) # reemplaza las claves del espacio de trabajo
box = sandboxes.create_sandbox()
print(box.ssh_command)
# ssh [email protected] -p 2222pethost sandbox shell k3x9q2m7v1c8p4ra # inicia sesión con un token, sin clave
scp -P 2222 results.csv [email protected]:/home/user/
ssh -p 2222 -N -L 5432:localhost:5432 [email protected]Cómo funciona
En el sandbox no se ejecuta ningún sshd. El gateway SSH del servidor te habla en SSH y se comunica con el propio daemon del sandbox por el vsock de la VM: tu shell, tu comando o SFTP se ejecuta como un proceso dentro del sandbox, y un puerto reenviado es un túnel hacia él. Así, todas las plantillas tienen SSH, también las tuyas, y nada dentro del sandbox escucha para ello. Lo que ejecutas por SSH es un comando como cualquier otro: aparece en list_commands y en los eventos del sandbox, marcado como iniciado por SSH.
El gateway comprueba tu clave o tu token antes de que nada despierte. Después, un inicio de sesión primero despierta un sandbox en pausa (PAUSED), con su memoria y sus procesos como estaban, y una sesión abierta lo mantiene despierto: con el ciclo de vida por defecto, vuelve a pausarse 5 minutos después de que termine la última sesión. Un sandbox detenido (STOPPED) rechaza el inicio de sesión con “stopped: resume it”, salvo que su ciclo de vida lo despierte estando detenido. Quitar una clave del espacio de trabajo termina las sesiones de esa clave.
Archivos y túneles
scp y sftp funcionan como con cualquier servidor. Para un archivo más grande del que lleva una llamada a la API, son la forma sencilla de meterlo y sacarlo; la API tiene enlaces de descarga y de subida para lo mismo.
ssh -L reenvía un puerto de tu equipo a un puerto dentro del sandbox: -L 5432:localhost:5432 llega a un Postgres que el sandbox guarda para sí, y -L 5173:localhost:5173 abre un servidor de desarrollo en tu navegador en localhost:5173 sin hacer público su puerto. Así es también como un navegador abre un puerto privado, ya que una pestaña del navegador no puede enviar el token que pide un puerto privado. Solo se reenvían los puertos del propio sandbox, nombrados como localhost; ssh -R se rechaza.
Límites y precios
Puerto 2222 en el servidor del sandbox; solo reenvío local. Un canal SSH cuenta entre las 64 llamadas, streams y enlaces que un sandbox atiende a la vez, y una sesión acepta hasta 64 variables de entorno de 32 KiB en total. Un token de conexión es una credencial de root: dáselo a un programa, nunca lo pongas en una página web. SSH no tiene precio propio. El sandbox se factura por segundo al precio de su tamaño, 0,018 US$ la hora para SMALL (2 vCPU, 4 GiB), y se ejecuta mientras haya una sesión abierta.
Cómo se compara
El 21 de noviembre de 2026, E2B llegaba al shell de un sandbox a través de un proxy WebSocket. boat.dev tiene SSH pero no pausa: tras una detención, su documentación dice que una reanudación en menos de 10 minutos “suele recuperar la misma máquina, con la memoria y los programas en ejecución. No cuentes con ello.”