# Connexion avec SSH, scp, sftp et rsync

Bientôt disponible. L’accès SSH standard et les connexions aux éditeurs ne sont pas encore offerts.

## Connexion après activation

Sur macOS ou Linux, installez rzv et OpenSSH, connectez-vous avec rzv login et sélectionnez votre espace de travail. Le bac à sable devra être en cours d’exécution et Runzivo devra offrir SSH dans votre environnement. SSH depuis un ordinateur Windows n’est pas encore pris en charge. Utilisez plutôt rzv sandboxes exec. La connexion exigera sandboxes:write. La configuration avec une clé API exigera sandboxes:read. Aucun port SSH ni aucune adresse IP publics ne seront nécessaires.

Commandes après activation. Remplacez \<sandbox-id\>

```
rzv sandboxes ssh <sandbox-id>
rzv sandboxes ssh <sandbox-id> -- 'uname -a'
rzv sandboxes ssh-config <sandbox-id>
rzv sandboxes ssh-config <sandbox-id> --write
ssh <sandbox-id>.rzv
scp file.txt <sandbox-id>.rzv:/workspace/
sftp <sandbox-id>.rzv
rsync -a -e ssh ./project/ <sandbox-id>.rzv:/workspace/project/
ssh -N -L 8080:localhost:3000 <sandbox-id>.rzv
```

## Utiliser VS Code ou Cursor

Ces étapes exigent une version du CLI qui prend en charge SSH. Aucune version de ce type n’est encore offerte. Parcours prévu : exécutez ssh-config avec --write comme ci-dessus. La commande gère son bloc Host et ajoute un Include à ~/.ssh/config en conservant le reste. Ajoutez --workspace \<id, slug ou nom\> à la génération de configuration. Une clé API exige l’ID exact de l’espace de travail. Vérifiez la connexion ssh, installez l’extension Remote SSH de votre éditeur, choisissez \<sandbox-id\>.rzv et ouvrez /workspace. Le ProxyCommand généré exécute rzv sandboxes ssh --stdio avec votre profil, votre espace de travail et votre liaison. Conservez la vérification de l’hôte. Nous n’avons pas encore testé VS Code ou Cursor avec un bac à sable réel.

Version simplifiée. Le fichier généré ajoute --profile, --workspace, --binding et une actualisation Match exec. Utilisez le fichier généré.

```
ProxyCommand rzv sandboxes ssh --stdio <sandbox-id>
```

## Transférer des fichiers

Utilisez l’alias SSH généré avec scp, sftp ou rsync. Vérifiez les fichiers avant de les copier : les dossiers sources contiennent parfois des identifiants. Conservez la vérification des clés d’hôte et ne collez aucun jeton dans les commandes.

Utilisez rzv sandboxes terminal \<sandbox-id\> pour le terminal PTY existant. Seule la commande rzv sandboxes ssh \<sandbox-id\> sans arguments supplémentaires utilisera ce terminal si SSH ou OpenSSH est indisponible. Les commandes distantes et les transferts de fichiers recevront plutôt des instructions.

## Redirection et limites

La redirection locale atteindra uniquement les services sur localhost du bac à sable. La redirection distante, celle de l’agent SSH, X11, les tunnels et les sockets Unix seront désactivés. Limites prévues : au plus deux sessions SSH par bac à sable. Les sessions se fermeront après trente minutes d’inactivité, à l’arrêt, à l’expiration ou à la suppression du bac à sable.

## Cas d’utilisation : réviser le travail d’un agent

Parcours prévu : connectez votre éditeur avec Remote SSH et ouvrez /workspace. Laissez votre agent modifier les fichiers et examinez les différences avant de créer un commit. Redirigez un port local vers un aperçu sur localhost du bac à sable. Récupérez le travail avant la fin de sa durée de vie de huit heures.

## Pages liées et langue

[Exemple avec un éditeur](https://runzivo.dev/docs/sandboxes-devx-example-editor-fr-ca/)

[English](https://runzivo.dev/docs/sandboxes-ssh/)

On this page and page tools