Español
Empezar

Agent Sandboxes SSH normal, scp y túneles

SSH a cualquier sandbox

Las herramientas que ya usas, apuntando a un sandbox: ssh para un shell, scp y sftp para archivos, ssh -L para un puerto. No hay servidor SSH que instalar, y un inicio de sesión despierta un sandbox en pausa donde estaba.

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 2222
pethost 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.”

Leer la documentación

Preguntas

¿Necesito sshd en mi plantilla para entrar por SSH a un sandbox?

No. El servidor responde a SSH y ejecuta tu sesión dentro del sandbox, así que todas las plantillas lo tienen, la nuestra o una que guardaste.

¿Qué puerto?

El 2222, en el servidor del sandbox, como dice su ssh_command.

¿Una sesión SSH mantiene despierto el sandbox?

Sí, mientras está abierta. Cuando se cierra, los temporizadores de inactividad del sandbox vuelven a correr: por defecto se pausa tras 5 minutos.

¿Puedo copiar archivos?

Sí, con scp o sftp, o a través de la API: write_files hasta 17 MiB, un enlace de descarga o de subida para cualquier tamaño.

¿Puede un programa iniciar sesión sin clave?

Sí, con un token de connect_sandbox como contraseña. Dura una hora salvo que pidas hasta un día, y revocar los tokens del sandbox hace que deje de funcionar.

Relacionado

Dale a tu agente una VM en 0,15 s

Empezar la prueba gratis