---
title: "SSH dans une sandbox : shell, scp et tunnels · Pethost"
description: "ssh, scp, sftp et ssh -L vers toute sandbox Pethost, avec votre clé ou un token d’une heure comme mot de passe. Une connexion réveille une sandbox en pause."
---

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

Une commande ssh vers une sandbox en pause, sur le port 2222, la réveille et ouvre un shell ; puis un fichier est copié avec scp et un port redirigé avec ssh -L.

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

Python

CLI

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

```
pethost sandbox shell k3x9q2m7v1c8p4ra   # se connecte avec un token, sans clé
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
```

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

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

- [Une visite à l’adresse HTTPS du port 3000 réveille une sandbox en pause en 0,2 s et sa page s’affiche ; un port privé répond 200 à une requête avec son token et 401 à une requête sans. Une URL pour chaque port Un serveur de développement sur le port 3000 répond à sa propre adresse HTTPS, publique ou derrière un token, et une visite réveille une sandbox en pause en 0,2 s environ. Comment ça marche](https://pethost.dev/fr/sandboxes/preview-urls/)
- [Un programme appelle run_command et la sortie des tests revient en direct ; il modifie un fichier sur place ; il lance un serveur de développement et l’appel répond dès que le port 5173 écoute. Commandes, fichiers et terminal Lancez une commande et attendez son port, suivez sa sortie en direct, modifiez des fichiers par remplacement exact, ouvrez un terminal dans le navigateur : un appel d’API chacun. Comment ça marche](https://pethost.dev/fr/sandboxes/code-execution/)

## Donnez un ordinateur à votre agent en 0,15 s

[Démarrer l’essai gratuit](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Templates](https://pethost.dev/fr/templates/)
- [À propos](https://pethost.dev/about/)
- [Docs](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/fr/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Conditions](https://pethost.dev/terms/)
- [Confidentialité](https://pethost.dev/privacy/)
- [Remboursements](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bases de données

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

Agent Sandboxes

- [Sandboxes](https://pethost.dev/fr/sandboxes/)
- [Tarifs](https://pethost.dev/fr/sandboxes/#pricing)
- [Docs](https://pethost.dev/fr/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Comparatifs

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/fr/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/fr/blog/coolify-cloud-vs-dokploy-cloud/)
- [Tarifs Railway vs Render vs Fly.io](https://pethost.dev/fr/blog/railway-vs-render-vs-fly-io-pricing/)
- [Hébergement Docker Compose managé](https://pethost.dev/fr/blog/managed-docker-compose-hosting/)

Alternatives

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