---
title: "Per SSH in eine Sandbox: Shell, scp und Tunnel · Pethost"
description: "Einfaches ssh, scp, sftp und ssh -L in jede Pethost-Sandbox, mit deinem Key oder einem Token für eine Stunde als Passwort. Ein Login weckt eine pausierte."
---

[Agent Sandboxes](https://pethost.dev/de/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.

Ein ssh-Befehl an eine pausierte Sandbox auf Port 2222 weckt sie und öffnet eine Shell; dann geht eine Datei mit scp hinüber, und ein Port wird mit ssh -L weitergeleitet.

## 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 k3x9q2m7v1c8p4ra@sbx1.sandboxes.pethost.network -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.

Python

CLI

```
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 k3x9q2m7v1c8p4ra@sbx1.sandboxes.pethost.network -p 2222
```

```
pethost sandbox shell k3x9q2m7v1c8p4ra   # meldet sich mit einem Token an, ohne Key
scp -P 2222 results.csv k3x9q2m7v1c8p4ra@sbx1.sandboxes.pethost.network:/home/user/
ssh -p 2222 -N -L 5432:localhost:5432 k3x9q2m7v1c8p4ra@sbx1.sandboxes.pethost.network
```

## 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](https://pethost.dev/de/sandboxes/preview-urls/) 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](https://pethost.dev/de/docs/sandboxes/ssh/)

## 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

- [Ein Besuch der HTTPS-Adresse von Port 3000 weckt eine pausierte Sandbox in 0,2 s, und ihre Seite erscheint; ein privater Port antwortet 200 auf einen Request mit seinem Token und 401 auf einen ohne. Eine URL für jeden Port Ein Dev-Server auf Port 3000 antwortet unter einer eigenen HTTPS-Adresse, öffentlich oder hinter einem Token, und ein Besuch weckt eine pausierte Sandbox in etwa 0,2 s. So funktioniert es](https://pethost.dev/de/sandboxes/preview-urls/)
- [Ein Programm ruft run_command auf, und die Testausgabe streamt zurück; es bearbeitet eine Datei direkt; es startet einen Dev-Server, und der Aufruf antwortet, sobald Port 5173 lauscht. Befehle, Dateien und ein Terminal Führ einen Befehl aus und warte auf seinen Port, streame seine Ausgabe, bearbeite Dateien per exaktem Ersetzen, öffne ein Terminal im Browser: je ein API-Aufruf. So funktioniert es](https://pethost.dev/de/sandboxes/code-execution/)

## Gib deinem Agenten einen Computer in 0,15 s

[Kostenlose Testphase starten](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Vorlagen](https://pethost.dev/de/templates/)
- [Über uns](https://pethost.dev/about/)
- [Doku](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/de/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [AGB](https://pethost.dev/terms/)
- [Datenschutz](https://pethost.dev/privacy/)
- [Erstattung](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Datenbanken

- [Postgres](https://pethost.dev/de/postgres/)
- [Valkey](https://pethost.dev/de/valkey/)

Agent Sandboxes

- [Sandboxes](https://pethost.dev/de/sandboxes/)
- [Preise](https://pethost.dev/de/sandboxes/#pricing)
- [Doku](https://pethost.dev/de/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Vergleiche

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/de/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/de/blog/coolify-cloud-vs-dokploy-cloud/)
- [Railway vs Render vs Fly.io Preise](https://pethost.dev/de/blog/railway-vs-render-vs-fly-io-pricing/)
- [Managed Hosting für Docker Compose](https://pethost.dev/de/blog/managed-docker-compose-hosting/)

Alternativen

- [Railway-Alternativen](https://pethost.dev/de/blog/railway-alternatives/)
- [Heroku-Alternativen](https://pethost.dev/de/blog/heroku-alternatives/)
- [Dokploy-Alternativen](https://pethost.dev/de/blog/dokploy-alternatives/)
- [Coolify-Alternativen](https://pethost.dev/de/blog/coolify-alternatives/)
- [Render-Alternativen](https://pethost.dev/de/blog/render-alternatives/)
- [Sliplane-Alternativen](https://pethost.dev/de/blog/sliplane-alternatives/)
