Zum Hauptinhalt springen

Per SSH verbinden

Ihr VPS Pro öffnet sich mit Ihrem SSH-Schlüssel: einem Dateipaar, das auf Ihrem Computer erstellt wird und dessen öffentlichen Teil Sie in Ihrem Kundenbereich hinterlegen. Der private Teil bleibt auf Ihrem Computer und geht an niemanden, auch nicht an unser Team.

Ihren Schlüssel erstellen​

Unter macOS, Linux und Windows 10 oder 11 (PowerShell oder das Terminal) genügt ein einziger Befehl:

ssh-keygen -t ed25519

Übernehmen Sie den vorgeschlagenen Speicherort und wählen Sie eine Passphrase, um den Schlüssel zu schützen. Im Ordner .ssh Ihres Benutzerkontos erscheinen zwei Dateien:

  • id_ed25519: Ihr privater Schlüssel, der bei Ihnen bleibt;
  • id_ed25519.pub: Ihr öffentlicher Schlüssel, den Sie hinterlegen. Er passt in eine Zeile, die mit ssh-ed25519 beginnt.

So zeigen Sie den öffentlichen Schlüssel an, um ihn zu kopieren:

cat ~/.ssh/id_ed25519.pub

Ihren Schlüssel im Kundenbereich hinterlegen​

  1. Öffnen Sie my.simafri.com, Rubrik VPS.
  2. Fügen Sie in der Karte Ihres Servers Ihren öffentlichen Schlüssel in Ihre öffentlichen Schlüssel, einer pro Zeile ein.
  3. Klicken Sie auf Schlüssel speichern.

Ihr Schlüssel wird innerhalb einer Minute auf dem Server eingerichtet, und die Karte zeigt es an: Auf dem Server eingerichtet am gefolgt vom Datum, mit dem Fingerabdruck jedes Schlüssels (SHA256:..., derselbe, den ssh-keygen -lf ~/.ssh/id_ed25519.pub anzeigt). Hinterlegen Sie ihn während der Vorbereitung des Servers, wird er bei dessen Erstellung eingerichtet.

Gut zu wissen:

  • bis zu 10 Schlüssel pro Server, einer pro Person oder pro Computer;
  • akzeptierte Typen: ed25519, RSA mit mindestens 2048 Bit, ECDSA sowie Hardware-Sicherheitsschlüssel (sk-ssh-ed25519, sk-ecdsa); das PuTTYgen-Format wird ebenfalls akzeptiert;
  • jedes Speichern ersetzt alle hinterlegten Schlüssel: Fügen Sie alle ein, die Sie behalten möchten;
  • der Inhaber des Kontos und die Verwalter hinterlegen die Schlüssel; ein Bearbeiter sieht sie ein (siehe Mitglieder und Rollen).

Die aus dem Kundenbereich hinterlegten Schlüssel belegen einen eigenen Block in der Datei /root/.ssh/authorized_keys, zwischen zwei Markierungszeilen my.simafri.com. Der Rest der Datei gehört Ihnen: Ein Schlüssel, den Sie selbst außerhalb dieses Blocks hinzufügen, bleibt erhalten.

Sich verbinden​

Die Karte Ihres Servers zeigt den Befehl SSH-Verbindung, bereit zum Kopieren:

ssh -p 22101 root@203.0.113.10

Der Port, zwischen 22100 und 22999, gehört zu Ihrem Server: Übernehmen Sie den aus Ihrer Karte. Der Name Ihres Servers funktioniert auch anstelle der Adresse:

ssh -p 22101 root@app.meine-firma.de

Bei einem Server, dessen Name unter Ihrer eigenen Domain liegt, antwortet dieser Name, sobald Ihr DNS-Eintrag auf Ihren Server verweist (siehe Eine Website oder Anwendung online stellen).

Über IPv6​

Verfügt Ihr Internetanschluss über IPv6, erreichen Sie Ihren Server auch direkt über seine IPv6-Adresse, die in der Karte angezeigt wird, auf dem üblichen SSH-Port:

ssh root@2001:db8::101

Eine Abkürzung: die Datei ~/.ssh/config​

Um Port und Adresse nicht mehr eintippen zu müssen, fügen Sie Ihrer Datei ~/.ssh/config einen Block hinzu:

Host monvps
    HostName app.meine-firma.de
    Port 22101
    User root
    IdentityFile ~/.ssh/id_ed25519

Danach genügt ssh monvps, und dieselbe Abkürzung dient für scp, rsync, git und Ihren Editor.

Von Windows aus​

Windows 10 und 11 enthalten den OpenSSH-Client: Öffnen Sie PowerShell oder das Terminal und fügen Sie den Befehl aus Ihrer Karte ein. Ihre Abkürzungsdatei liegt unter C:\Users\<Ihr Name>\.ssh\config.

Mit PuTTY tragen Sie Adresse und Port aus Ihrer Karte unter Session ein, den Benutzer root unter Connection > Data und Ihren privaten Schlüssel im Format .ppk unter Connection > SSH > Auth > Credentials. Der von PuTTYgen angezeigte öffentliche Schlüssel wird unverändert in Ihrem Kundenbereich hinterlegt.

Dateien übertragen​

Mit demselben Port und demselben Schlüssel:

# eine Datei, zum Server
scp -P 22101 archive.tar.gz root@app.meine-firma.de:/srv/

# ein Ordner, synchronisiert
rsync -avz -e "ssh -p 22101" ./build/ root@app.meine-firma.de:/var/www/app/

scp nimmt den Port mit einem großen P. SFTP-Programme wie FileZilla oder WinSCP verbinden sich per SFTP, mit der Adresse, dem Port und dem privaten Schlüssel Ihres Computers.

Aus Ihrem Editor arbeiten​

Die Erweiterung Remote - SSH von Visual Studio Code öffnet die Ordner Ihres Servers, als lägen sie auf Ihrem Computer: Sie liest Ihre Datei ~/.ssh/config, und es genügt, monvps zu wählen. Die JetBrains-Editoren bieten dieselbe Verbindung über Remote Development.

Einem Kollegen Zugang geben​

Zwei Wege, je nachdem, was Sie ihm anvertrauen möchten:

  • ein Administratorzugang: Fügen Sie seinen öffentlichen Schlüssel neben Ihrem in Ihre öffentlichen Schlüssel, einer pro Zeile ein, dann Schlüssel speichern;
  • ein eingeschränkter Zugang: Legen Sie ihm ein Konto auf dem Server an, mit seinem eigenen Schlüssel:
adduser camille
mkdir -p /home/camille/.ssh
nano /home/camille/.ssh/authorized_keys   # seinen öffentlichen Schlüssel einfügen
chown -R camille:camille /home/camille/.ssh
chmod 700 /home/camille/.ssh && chmod 600 /home/camille/.ssh/authorized_keys

Um einen Zugang zu entziehen, speichern Sie die Schlüsselliste ohne seinen Schlüssel, oder löschen Sie sein Konto mit deluser camille.

Einen verlorenen Schlüssel ersetzen​

Ihr Computer hat gewechselt oder Ihr privater Schlüssel ist verschwunden: Erstellen Sie mit ssh-keygen -t ed25519 einen neuen Schlüssel und hinterlegen Sie dann den neuen öffentlichen Schlüssel in Ihrer Karte, wobei Sie den alten entfernen. Er wird innerhalb einer Minute eingerichtet, und Sie haben wieder Zugang zu Ihrem Server.

Ihr KI-Assistent​

Ein KI-Assistent, der mit Ihrem Simafri-Kundenbereich verbunden ist (MCP-Server https://mcp.simafri.com/v1/mcp), liest Ihre Server, ihren Status, ihre Adressen und ihren Verbindungsbefehl und hinterlegt Ihre öffentlichen Schlüssel für Sie, mit den Rechten der angemeldeten Person. Ein privater Schlüssel wird dort abgelehnt, wie im Kundenbereich.

Häufige Fragen​

„Permission denied (publickey)“: Was prüfen?​

  1. Die Karte Ihres Servers zeigt Auf dem Server eingerichtet am gefolgt von einem Datum.
  2. Der in der Karte angezeigte Fingerabdruck ist der Ihres Schlüssels: ssh-keygen -lf ~/.ssh/id_ed25519.pub.
  3. Ihr Befehl nennt wirklich den Port aus Ihrer Karte und den Benutzer root.
  4. Trägt Ihr Schlüssel einen anderen Namen, geben Sie ihn an: ssh -i ~/.ssh/ma_cle -p 22101 root@....

Beschreiben Sie dann die Lage dem Support, mit dem ausgeführten Befehl und der erhaltenen Meldung: Der Full-Stack-Support hilft Ihnen, den Zugang wiederherzustellen.

Meine Verbindung bricht ab, wenn ich inaktiv bin.​

Fügen Sie ServerAliveInterval 60 Ihrem Block in ~/.ssh/config hinzu: Ihr Computer hält die Verbindung aufrecht. Einen langen Befehl starten Sie in tmux oder screen, die ihn auch nach dem Trennen der Verbindung am Leben halten.

Der Kundenbereich meldet „Dieser Text enthält einen PRIVATEN Schlüssel“.​

Sie haben die Datei ohne .pub eingefügt. Fügen Sie den Inhalt der Datei mit der Endung .pub ein. Wurde Ihr privater Schlüssel versehentlich an jemanden gesendet, erstellen Sie einen neuen und hinterlegen Sie dessen öffentlichen Schlüssel.

Kann ich mich mit einem Passwort verbinden?​

Ihr Server öffnet sich per SSH-Schlüssel, der sichersten Methode: Ein Schlüssel lässt sich nicht erraten und wird nie übertragen. Hinterlegen Sie einen Schlüssel pro Person, und jede behält ihren eigenen Zugang.