Français
Commencer

Agent Sandboxes SSH, scp et tunnels standard

SSH dans n’importe quelle sandbox

Les outils que vous utilisez déjà, pointés vers une sandbox : ssh pour un shell, scp et sftp pour les fichiers, ssh -L pour un port. Aucun serveur SSH à installer, et une connexion réveille une sandbox en pause là où elle en était.

Comment se connecter en SSH à une sandbox

Chaque sandbox répond en SSH sur le port 2222 de son serveur, avec l’ID de la sandbox comme nom d’utilisateur. Sa fiche contient la commande complète, ssh_command, par exemple ssh [email protected] -p 2222.

Deux choses vous connectent. Une clé publique de l’espace de travail : ajoutez la vôtre une fois avec set_ssh_keys ou dans les paramètres de la console web, et elle ouvre toutes les sandboxes de l’espace de travail. Ou un token de connexion comme mot de passe, pour un programme qui n’a pas de clé : connect_sandbox en crée un pour une sandbox, valable une heure par défaut et un jour au plus. pethost sandbox shell en crée un pour vous et se connecte avec.

from pathlib import Path
from pethost.sandboxes import Sandboxes

sandboxes = Sandboxes()  # lit PETHOST_TOKEN
key = Path("~/.ssh/id_ed25519.pub").expanduser().read_text()
sandboxes.set_ssh_keys(ssh_keys=[key])  # remplace les clés de l'espace de travail
box = sandboxes.create_sandbox()
print(box.ssh_command)
# ssh [email protected] -p 2222
pethost sandbox shell k3x9q2m7v1c8p4ra   # se connecte avec un token, sans clé
scp -P 2222 results.csv [email protected]:/home/user/
ssh -p 2222 -N -L 5432:localhost:5432 [email protected]

Comment ça marche

Aucun sshd ne tourne dans la sandbox. La passerelle SSH du serveur vous parle en SSH et dialogue avec le démon de la sandbox par le vsock de la VM : votre shell, votre commande ou SFTP s’exécute comme un processus dans la sandbox, et un port redirigé est un tunnel vers elle. Chaque template a donc SSH, le vôtre compris, et rien dans la sandbox n’écoute pour cela. Ce que vous lancez par SSH est une commande comme les autres : elle apparaît dans list_commands et dans les événements de la sandbox, marquée comme lancée par SSH.

La passerelle vérifie votre clé ou votre token avant que quoi que ce soit ne se réveille. Ensuite, une connexion réveille d’abord une sandbox PAUSED, sa mémoire et ses processus tels qu’ils étaient, et une session ouverte la garde éveillée : avec le cycle de vie par défaut, elle se remet en pause 5 minutes après la fin de la dernière session. Une sandbox STOPPED refuse la connexion avec « stopped: resume it », sauf si son cycle de vie la réveille quand elle est arrêtée. Retirer une clé de l’espace de travail ferme les sessions de cette clé.

Fichiers et tunnels

scp et sftp marchent comme avec n’importe quel serveur. Pour un fichier plus gros que ce que transporte un appel d’API, c’est le moyen simple d’entrer et de sortir ; l’API a des liens de téléchargement et d’envoi pour la même chose.

ssh -L redirige un port de votre ordinateur vers un port de la sandbox : -L 5432:localhost:5432 atteint un Postgres que la sandbox garde pour elle, et -L 5173:localhost:5173 ouvre un serveur de développement dans votre navigateur sur localhost:5173 sans rendre son port public. C’est aussi comme cela qu’un navigateur ouvre un port privé, puisqu’un onglet ne peut pas envoyer le token qu’exige un port privé. Seuls les ports de la sandbox elle-même sont redirigés, désignés par localhost ; ssh -R est refusé.

Limites et prix

Le port 2222 sur le serveur de la sandbox ; redirection locale seulement. Un canal SSH compte parmi les 64 appels, flux et liens qu’une sandbox sert en même temps, et une session accepte jusqu’à 64 variables d’environnement, 32 KiB en tout. Un token de connexion donne un accès root : confiez-le à un programme, ne le mettez jamais dans une page web. SSH n’a pas de prix à part. La sandbox est facturée à la seconde au prix de sa taille, 0,018 $ de l’heure pour SMALL (2 vCPU, 4 GiB), et tourne tant qu’une session est ouverte.

Face aux autres

Le 21 novembre 2026, E2B donnait accès au shell d’une sandbox par un proxy WebSocket. boat.dev a SSH mais pas de pause : après un arrêt, sa documentation dit qu’une reprise dans les 10 minutes « récupère généralement la même machine, avec sa mémoire et ses programmes en cours. N’y comptez pas. »

Lire la documentation

Questions

Faut-il sshd dans mon template pour me connecter en SSH à une sandbox ?

Non. Le serveur répond en SSH et lance votre session dans la sandbox : chaque template l’a, le nôtre ou un que vous avez enregistré.

Quel port ?

2222, sur le serveur de la sandbox, comme l’indique son ssh_command.

Une session SSH garde-t-elle la sandbox éveillée ?

Oui, tant qu’elle est ouverte. Une fois fermée, les délais d’inactivité de la sandbox reprennent : par défaut, elle se met en pause après 5 minutes.

Puis-je copier des fichiers ?

Oui, avec scp ou sftp, ou par l’API : write_files jusqu’à 17 MiB, un lien de téléchargement ou d’envoi pour toute taille.

Un programme peut-il se connecter sans clé ?

Oui, avec un token de connect_sandbox comme mot de passe. Il dure une heure, sauf si vous demandez jusqu’à un jour, et révoquer les tokens de la sandbox le rend inutilisable.

Voir aussi

Donnez un ordinateur à votre agent en 0,15 s

Démarrer l’essai gratuit