Deutsch
Loslegen

Agent Sandboxes Einfaches SSH, scp und Tunnel

Per SSH in jede Sandbox

Die Tools, die du schon nutzt, auf eine Sandbox gerichtet: ssh für eine Shell, scp und sftp für Dateien, ssh -L für einen Port. Es gibt keinen SSH-Server zu installieren, und ein Login weckt eine pausierte Sandbox dort, wo sie war.

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

Doku lesen

Fragen

Brauche ich sshd in meiner Vorlage, um per SSH in eine Sandbox zu kommen?

Nein. Der Server antwortet auf SSH und führt deine Sitzung in der Sandbox aus, also hat jede Vorlage es, unsere oder eine, die du gespeichert hast.

Welcher Port?

2222, auf dem Server der Sandbox, wie ihr ssh_command sagt.

Hält eine SSH-Sitzung die Sandbox wach?

Ja, solange sie offen ist. Sobald sie geschlossen ist, laufen die Leerlauf-Timer der Sandbox wieder: Standardmäßig pausiert sie nach 5 min.

Kann ich Dateien kopieren?

Ja, mit scp oder sftp, oder über die API: write_files für bis zu 17 MiB, ein Download- oder Upload-Link für jede Größe.

Kann sich ein Programm ohne Key anmelden?

Ja, mit einem Token von connect_sandbox als Passwort. Es gilt eine Stunde, außer du verlangst bis zu einem Tag, und wenn du die Tokens der Sandbox widerrufst, funktioniert es nicht mehr.

Verwandte Funktionen

Gib deinem Agenten einen Computer in 0,15 s

Kostenlose Testphase starten