Se connecter à votre box en SSH

Chaque box accepte SSH sur ssh <box>@ssh.detachbox.com avec les clés de votre compte. Ajoutez une clé une fois : toutes vos box la laissent entrer. La redirection de ports, rsync et Remote-SSH dans VS Code ou Cursor passent par la même adresse.

Ajouter votre clé SSH

Les box n’acceptent que des clés, jamais de mots de passe.

1. Sur votre ordinateur, affichez votre clé publique :

   cat ~/.ssh/id_ed25519.pub
   

   Pas encore de clé ? Créez-en une avec ssh-keygen -t ed25519.

2. Dans le tableau de bord, ouvrez Clés SSH et choisissez Ajouter une clé SSH.

3. Collez la ligne entière. Elle commence par ssh-ed25519, ssh-rsa ou ecdsa-sha2.

4. Nommez la clé, par exemple portable. Laissez le nom vide pour reprendre le commentaire de la clé.

5. Choisissez Ajouter une clé SSH.

Chaque clé de votre compte ouvre toutes vos box, et chaque box la récupère d’elle-même. Un compte garde jusqu’à 50 clés.

Collez uniquement le fichier .pub. Le tableau de bord refuse une clé privée, et la moitié privée ne quitte jamais votre portable.

Importer vos clés depuis GitHub

1. Sur Clés SSH, choisissez Importer depuis GitHub.
2. Saisissez votre nom d’utilisateur GitHub.
3. Choisissez Importer les clés.

Le tableau de bord prend chaque clé publique listée sur github.com/<username>.keys. Les clés déjà présentes sur votre compte sont ignorées.

Se connecter à une box

Copiez la commande depuis Connexion en SSH dans la Vue d’ensemble de la box, puis lancez-la :

ssh [email protected]

Vous arrivez dans la box en tant qu’utilisateur dev. Pour ne plus taper l’adresse, ajoutez la box à ~/.ssh/config :

Host my-box
  HostName ssh.detachbox.com
  User my-box

Ensuite, ssh my-box suffit.

Vérifier la clé d’hôte

À la première connexion, SSH vous demande de faire confiance à l’hôte. Ouvrez Vérifier la clé de l’hôte sous Connexion en SSH et comparez l’empreinte affichée avec celle que SSH imprime. Répondez yes uniquement si elles concordent.

Rejoindre vos onglets de terminal en SSH

Chaque onglet du navigateur est une session tmux sur la box : SSH atteint donc les mêmes sessions.

tmux ls
tmux attach -t <session>

Détachez-vous avec Ctrl+B puis D. L’agent continue de travailler.

Lancer une commande sur la box

ssh [email protected] 'docker ps'

Les variables DETACHBOX_* de box.env se chargent aussi dans ces shells. Agents les liste.

Rediriger un serveur de dev ou une base de données

Redirigez un port vers votre ordinateur avec -L :

ssh -L 3000:localhost:3000 [email protected]

Ouvrez localhost:3000 sur votre portable pour voir l’app qui tourne dans la box. La page de la box donne cette commande sous Rediriger un serveur de dev.

Pour une base de données ou n’importe quel port TCP brut, redirigez sans shell :

ssh -N -L 5432:localhost:5432 [email protected]

Pour les applications web, une URL d’aperçu se passe de tunnel et s’ouvre aussi sur votre téléphone.

Copier un dossier avec rsync

Le terminal du navigateur refuse les dossiers. Copiez un dossier avec rsync :

rsync -az ./my-folder/ [email protected]:~/my-folder/

Inversez les deux chemins pour copier de la box vers votre ordinateur.

Ouvrir la box dans VS Code ou Cursor

Les deux éditeurs se connectent via leur extension Remote-SSH, avec votre propre clé.

1. Ajoutez votre clé dans Clés SSH.
2. Dans l’éditeur, connectez-vous à l’hôte [email protected].

Depuis le terminal du navigateur, ouvrez un chemin de fichier dans la visionneuse et choisissez Ouvrir dans VS Code ou Ouvrir dans Cursor. L’éditeur ouvre ce fichier à cette ligne via Remote-SSH. S’il n’arrive pas à se connecter, ajoutez votre clé dans Clés SSH.

Supprimer une clé

1. Sur Clés SSH, ouvrez le menu de la clé et choisissez Supprimer la clé.
2. Confirmez.

Plus aucune box n’accepte cette clé. Supprimer votre seule clé bloque SSH jusqu’à ce que vous en ajoutiez une autre. Le terminal du navigateur, lui, continue de fonctionner.

Permission denied ?

Permission denied (publickey) signifie que la box n’a pas reçu de clé qu’elle connaît. Vérifiez que la clé de votre ordinateur figure bien dans Clés SSH, et que l’utilisateur dans la commande est le nom de la box. Dépannage propose d’autres solutions.