So kommst du per SSH in eine Sandbox
Jede Sandbox antwortet auf SSH an Port 2222 ihres Servers, mit der ID der Sandbox als Benutzername. Ihr Eintrag enthält den ganzen Befehl, ssh_command, etwa ssh [email protected] -p 2222.
Zwei Dinge melden dich an. Ein Public Key des Workspace: Füg deinen einmal mit set_ssh_keys oder in den Einstellungen der Web-Konsole hinzu, und er öffnet jede Sandbox des Workspace. Oder ein Verbindungs-Token als Passwort, für ein Programm, das keinen Key hat: connect_sandbox erstellt eins für eine Sandbox, standardmäßig eine Stunde gültig und höchstens einen Tag. pethost sandbox shell erstellt eins für dich und meldet dich damit an.
from pathlib import Path
from pethost.sandboxes import Sandboxes
sandboxes = Sandboxes() # liest PETHOST_TOKEN
key = Path("~/.ssh/id_ed25519.pub").expanduser().read_text()
sandboxes.set_ssh_keys(ssh_keys=[key]) # ersetzt die Keys des Workspace
box = sandboxes.create_sandbox()
print(box.ssh_command)
# ssh [email protected] -p 2222pethost sandbox shell k3x9q2m7v1c8p4ra # meldet sich mit einem Token an, ohne Key
scp -P 2222 results.csv [email protected]:/home/user/
ssh -p 2222 -N -L 5432:localhost:5432 [email protected]Wie es funktioniert
In der Sandbox läuft kein sshd. Das SSH-Gateway des Servers spricht SSH mit dir und redet über den vsock der VM mit dem eigenen Daemon der Sandbox: Deine Shell, dein Befehl oder SFTP läuft als Prozess in der Sandbox, und ein weitergeleiteter Port ist ein Tunnel hinein. So hat jede Vorlage SSH, deine eingeschlossen, und nichts in der Sandbox lauscht dafür. Was du über SSH ausführst, ist ein Befehl wie jeder andere: Er erscheint in list_commands und in den Events der Sandbox, als über SSH gestartet markiert.
Das Gateway prüft deinen Key oder dein Token, bevor irgendetwas aufwacht. Dann weckt ein Login zuerst eine pausierte Sandbox, RAM und Prozesse wie zuvor, und eine offene Sitzung hält sie wach: Mit dem Standard-Lebenszyklus pausiert sie 5 min nach dem Ende der letzten Sitzung wieder. Eine gestoppte Sandbox lehnt den Login mit „stopped: resume it“ ab, außer ihr Lebenszyklus weckt sie auch gestoppt. Wird ein Key aus dem Workspace entfernt, enden die Sitzungen dieses Keys.
Dateien und Tunnel
scp und sftp funktionieren wie bei jedem Server. Für eine Datei, die größer ist, als ein API-Aufruf trägt, sind sie der einfache Weg hinein und hinaus; die API hat Download- und Upload-Links für dasselbe.
ssh -L leitet einen Port deines Computers an einen Port in der Sandbox weiter: -L 5432:localhost:5432 erreicht ein Postgres, das die Sandbox für sich behält, und -L 5173:localhost:5173 öffnet einen Dev-Server in deinem Browser unter localhost:5173, ohne seinen Port öffentlich zu machen. So öffnet ein Browser auch einen privaten Port, da ein Browser-Tab das Token nicht mitschicken kann, das ein privater Port verlangt. Weitergeleitet werden nur die eigenen Ports der Sandbox, als localhost angegeben; ssh -R wird abgelehnt.
Grenzen und Preise
Port 2222 auf dem Server der Sandbox; nur lokale Weiterleitung. Ein SSH-Kanal zählt zu den 64 Aufrufen, Streams und Links, die eine Sandbox gleichzeitig bedient, und eine Sitzung nimmt bis zu 64 Umgebungsvariablen mit zusammen 32 KiB. Ein Verbindungs-Token ist ein Root-Zugang: Gib es einem Programm, stell es nie in eine Webseite. SSH hat keinen eigenen Preis. Die Sandbox wird sekundengenau zum Preis ihrer Größe abgerechnet, 0,018 $ pro Stunde für SMALL (2 vCPU, 4 GiB), und läuft, solange eine Sitzung offen ist.
Im Vergleich
Am 21. November 2026 erreichte E2B die Shell einer Sandbox über einen WebSocket-Proxy. boat.dev hat SSH, aber keine Pause: Nach einem Stopp bekommt ein Fortsetzen innerhalb von 10 Minuten laut seiner Doku „meist dieselbe Maschine zurück, mit RAM und laufenden Programmen. Verlass dich nicht darauf.“