Per SSH mit deiner Box verbinden

Jede Box nimmt SSH unter ssh <box>@ssh.detachbox.com an, mit den Keys aus deinem Konto. Füg einen Key einmal hinzu, und jede deiner Boxen lässt ihn rein. Port-Forwarding, rsync und Remote-SSH in VS Code oder Cursor laufen über dieselbe Adresse.

Deinen SSH-Key hinzufügen

Boxen lassen nur Keys rein, keine Passwörter.

1. Gib auf deinem Rechner deinen Public Key aus:

   cat ~/.ssh/id_ed25519.pub
   

   Noch keinen Key? Erzeug einen mit ssh-keygen -t ed25519.

2. Öffne im Dashboard SSH-Keys und wähl SSH-Key hinzufügen.

3. Füg die ganze Zeile ein. Sie beginnt mit ssh-ed25519, ssh-rsa oder ecdsa-sha2.

4. Gib dem Key einen Namen, zum Beispiel laptop. Lässt du das Feld leer, wird der Kommentar des Keys zum Namen.

5. Wähl SSH-Key hinzufügen.

Jeder Key in deinem Konto öffnet jede deiner Boxen, und jede Box übernimmt den Key von selbst. Ein Konto hat bis zu 50 Keys.

Füg nur die .pub-Datei ein. Das Dashboard lehnt einen privaten Key ab, und die private Hälfte verlässt deinen Laptop nie.

Deine Keys von GitHub importieren

1. Wähl unter SSH-Keys Von GitHub importieren.
2. Gib deinen GitHub-Benutzernamen ein.
3. Wähl Keys importieren.

Das Dashboard übernimmt jeden Public Key, der unter github.com/<username>.keys steht. Keys, die schon in deinem Konto sind, werden übersprungen.

Mit einer Box verbinden

Kopier den Befehl aus Per SSH verbinden auf der Übersicht der Box und führ ihn aus:

ssh [email protected]

Du landest als Benutzer dev in der Box. Damit du die Adresse nicht jedes Mal tippen musst, trag die Box in ~/.ssh/config ein:

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

Danach verbindet ssh my-box.

Den Host-Key prüfen

Bei der ersten Verbindung fragt SSH, ob du dem Host vertraust. Öffne Host-Schlüssel prüfen unter Per SSH verbinden und vergleich den Fingerprint dort mit dem, den SSH ausgibt. Antworte nur mit yes, wenn sie übereinstimmen.

Deine Terminal-Tabs per SSH öffnen

Jeder Browser-Tab ist eine tmux-Session auf der Box, also erreicht SSH dieselben Sessions:

tmux ls
tmux attach -t <session>

Mit Ctrl+B und dann D löst du dich wieder. Der Agent arbeitet weiter.

Einen Befehl auf der Box ausführen

ssh [email protected] 'docker ps'

Die DETACHBOX_*-Variablen aus box.env werden auch in diesen Shells geladen. Agenten listet sie auf.

Einen Dev-Server oder eine Datenbank weiterleiten

Leite einen Port mit -L auf deinen Rechner weiter:

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

Öffne localhost:3000 auf deinem Laptop, und du siehst die App, die in der Box läuft. Die Seite der Box hat diesen Befehl unter Dev-Server weiterleiten.

Für eine Datenbank oder einen beliebigen TCP-Port leitest du ohne Shell weiter:

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

Für Web-Apps braucht eine Preview-URL keinen Tunnel und öffnet sich auch auf deinem Handy.

Einen Ordner mit rsync kopieren

Das Browser-Terminal nimmt keine Ordner an. Kopier einen Ordner mit rsync:

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

Tausch die beiden Pfade, um von der Box auf deinen Rechner zu kopieren.

Die Box in VS Code oder Cursor öffnen

Beide Editoren verbinden sich über ihre Remote-SSH-Erweiterung, mit deinem eigenen Key.

1. Füg deinen Key unter SSH-Keys hinzu.
2. Verbinde dich im Editor mit dem Host [email protected].

Öffne im Browser-Terminal einen Dateipfad im Viewer und wähl In VS Code öffnen oder In Cursor öffnen. Der Editor öffnet genau diese Datei an genau dieser Zeile über Remote-SSH. Klappt die Verbindung nicht, füg deinen Key unter SSH-Keys hinzu.

Einen Key entfernen

1. Öffne unter SSH-Keys das Menü des Keys und wähl Key löschen.
2. Bestätige.

Keine Box nimmt den Key danach noch an. Löschst du deinen einzigen Key, ist SSH gesperrt, bis du einen neuen hinzufügst. Das Browser-Terminal funktioniert weiter.

Permission denied?

Permission denied (publickey) heißt: Die Box hat keinen Key bekommen, den sie kennt. Prüf, ob der Key auf deinem Rechner unter SSH-Keys steht und ob der Benutzer im Befehl der Name der Box ist. Fehlerbehebung hat weitere Lösungen.