SSH: „Permission denied (publickey)“ beheben
Der Fehler „Permission denied (publickey)“ hat fünf Ursachen. Prüfen Sie die Ausgabe von ssh -v und beheben Sie das Problem, ohne den Zugang zu verlieren.
Was „Permission denied (publickey)“ tatsächlich bedeutet
„Permission denied (publickey)“ bedeutet, dass Ihr Client einen oder mehrere öffentliche Schlüssel gesendet hat und der Server keinen davon akzeptiert hat. Das Netzwerk funktioniert, und sshd läuft. Die Ablehnung erfolgt im letzten Schritt der Authentifizierung. Wenn Ihre Sitzung vorher beendet wird, handelt es sich stattdessen um „connection refused“ oder „connection timed out“. Das ist eine andere Diagnose mit anderen Prüfungen. Die Behebung erfolgt nicht durch Raten, weil ssh -v angibt, welche von fünf Ursachen vorliegt.
Die Wörter in den Klammern bezeichnen die Methoden, die der Server akzeptieren wollte. Permission denied (publickey) allein bedeutet, dass die Anmeldung per Passwort auf diesem Server deaktiviert ist. Es gibt daher kein Passwort als Ausweichmöglichkeit. Permission denied (publickey,password) bedeutet, dass Passwörter angeboten wurden und auch diese Anmeldung fehlgeschlagen ist.
Eine Meldung deckt fünf voneinander getrennte Fehler ab und bleibt absichtlich ungenau. Ein Server, der mit „Benutzer nicht vorhanden“ oder „dieser Schlüssel ist nicht installiert“ antworten würde, würde jedem helfen, nach gültigen Konten zu suchen. Beginnen Sie daher nicht damit, Schlüssel auszutauschen und Konfigurationsdateien zu bearbeiten. Führen Sie einen Befehl aus, lesen Sie drei Ausgabezeilen, und aus fünf möglichen Ursachen wird eine.
Führen Sie zuerst ssh -v aus und lesen Sie drei Zeilen
Wiederholen Sie den fehlgeschlagenen Befehl und ergänzen Sie -v:
ssh -v deploy@203.0.113.10Eine gekürzte, aber realistische Ausgabe sieht so aus:
OpenSSH_9.6p1 Ubuntu-3ubuntu13, OpenSSL 3.0.13 30 Jan 2024
debug1: Connecting to 203.0.113.10 [203.0.113.10] port 22.
debug1: Connection established.
debug1: Authenticating to 203.0.113.10:22 as 'deploy'
debug1: Authentications that can continue: publickey
debug1: Next authentication method: publickey
debug1: Will attempt key: /home/you/.ssh/id_ed25519 ED25519 SHA256:0eL/8sBw... agent
debug1: Offering public key: /home/you/.ssh/id_ed25519 ED25519 SHA256:0eL/8sBw... agent
debug1: Authentications that can continue: publickey
debug1: No more authentication methods to try.
deploy@203.0.113.10: Permission denied (publickey).Drei Zeilen enthalten alle erforderlichen Informationen.
Authenticating to 203.0.113.10:22 as 'deploy' ist der tatsächlich verwendete Benutzername. Nicht der Benutzername, den Sie verwenden wollten, sondern der Name, den ssh aus der Befehlszeile, aus ~/.ssh/config oder aus Ihrem lokalen Anmeldenamen ermittelt hat.
Authentications that can continue: publickey ist die Liste der vom Server akzeptierten Verfahren. Der Server sendet sie, bevor ein Schlüssel ausprobiert wird. Fehlt publickey in dieser ersten Liste, ist die Anmeldung per Public Key auf dem Server deaktiviert. Dann kann kein Schlüssel funktionieren.
Offering public key: ... wird für jeden Schlüssel ausgegeben, dessen öffentlichen Teil ssh bereits kennt, unmittelbar bevor ssh diesen Schlüssel anbietet. Danach folgen der Schlüsseltyp und sein SHA256-Fingerabdruck. Bei einem aus einer Datei gelesenen Schlüssel wird diese Datei angegeben. Ein Schlüssel, der nur in ssh-agent vorhanden ist, zeigt statt eines Pfads den Kommentar an, den der Agent für ihn gespeichert hat. Das Wort agent am Ende der Zeile kennzeichnet jeden vom Agent bereitgestellten Schlüssel. ssh gibt diese Zeile unmittelbar vor der Prüfung aus, ob beide Seiten denselben Signaturalgorithmus für den Schlüssel unterstützen. Wenn die nächste Zeile send_pubkey_test: no mutual signature algorithm lautet, wurde dieser Schlüssel daher letztlich nicht gesendet. Ursache 5 behandelt diesen Fall. Wenn ssh den öffentlichen Teil eines Schlüssels vorab nicht lesen konnte, wird keine Offering-Zeile ausgegeben. Stattdessen protokolliert ssh Trying private key: ... nur mit dem Dateinamen, lädt den privaten Schlüssel und sendet sofort eine signierte Anfrage. Ein Schlüssel ohne eine dieser beiden Zeilen wurde nie an den Server gesendet.
Teilen Sie das Problem nun in zwei Teile:
- Für den erwarteten Schlüssel gibt es keine
Offering public key- oderTrying private key-Zeile. Der Fehler liegt auf Ihrem Rechner, weil der Server Ihren Schlüssel überhaupt nicht erhalten hat. - Der Schlüssel wird angeboten und erneut
Authentications that can continue: publickeyausgegeben. Der Server hat den Schlüssel erhalten und abgelehnt. Der Fehler liegt daher auf dem Server.
Die folgenden Ursachen sind danach geordnet, wie häufig sie sich als zutreffend erweisen.
Ursache 1: Sie stellen die Verbindung mit dem falschen Benutzernamen her
Die häufigste Ursache ist zugleich die unspektakulärste. sshd, der SSH-Server-Daemon (Secure Shell), teilt Ihnen nie mit, dass ein Konto nicht existiert. Er führt den gesamten Austausch für einen erfundenen Benutzernamen durch und verweigert die Anmeldung erst am Ende mit derselben Meldung, weil gültige Kontonamen einem Angreifer helfen. Ein Tippfehler im Benutzernamen sieht daher genauso aus wie ein fehlerhafter Schlüssel.
Prüfen Sie zuerst die Zeile Authenticating to ... as. Wenn dort der Login-Name Ihres Laptops statt des Kontos auf dem Server steht, haben Sie den Benutzernamen im Befehl weggelassen.
ssh -v deploy@203.0.113.10
ssh -v root@203.0.113.10Das Standardkonto hängt vom Image ab, das Ihr Anbieter erstellt. Im August 2026 enthalten Ubuntu-Cloud-Images normalerweise ein Konto namens ubuntu, Debian-Images enthalten debian oder admin, Rocky Linux und AlmaLinux verwenden rocky und almalinux, und viele VPS-Anbieter installieren Ihren Schlüssel stattdessen direkt für root. Im Control Panel Ihres Anbieters ist vermerkt, welches Konto er erstellt hat. Kein Befehl, den Sie außerhalb des Servers ausführen, kann diese Information abfragen.
Ein Block Host in ~/.ssh/config legt den Benutzernamen ebenfalls fest. Dieser Wert hat Vorrang vor Ihrem lokalen Login-Namen:
Host vps-prod
HostName 203.0.113.10
User deployWenn Sie das Konto selbst erstellt haben und sich anschließend nicht damit anmelden konnten, wurde der Schlüssel wahrscheinlich für den Standardbenutzer des Images installiert und nicht auf das neue Konto kopiert. Dieser Schritt gehört zu den ersten zehn Minuten auf einem neuen VPS und wird leicht übersprungen.
Ursache 2: Der Schlüssel, den Sie zu senden glauben, wird nicht gesendet
Standardmäßig bietet ssh nur die Schlüssel aus ssh-agent sowie eine feste Gruppe von Dateinamen in ~/.ssh an: id_rsa, id_ecdsa, id_ed25519, die Varianten für Hardware-Schlüssel id_ecdsa_sk und id_ed25519_sk sowie den hybriden Post-Quantum-Schlüssel id_mldsa44_ed25519. Aktuelles OpenSSH unterstützt DSA überhaupt nicht mehr. OpenSSH 10.0 hat die Unterstützung im April 2025 entfernt. Eine alte Datei id_dsa wird daher nie ausprobiert. Ein unter ~/.ssh/vps-prod gespeicherter Schlüssel ist für ssh unsichtbar, bis Sie ihn angeben. Deshalb zeigt die ausführliche Ausgabe dafür keine Offering public key-Zeile.
Geben Sie die Datei an und verhindern Sie, dass die Schlüssel des Agenten an ihre Stelle treten:
ssh -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@203.0.113.10-i allein reicht nicht aus, wenn der Agent Schlüssel enthält. ssh bietet die Schlüssel des Agenten weiterhin zuerst und die angegebene Datei zuletzt an. Das ist relevant, weil ein Server mit einer OpenSSH-Version vor 10.6 jeden abgelehnten Schlüssel auf MaxAuthTries anrechnet. Dieser Wert ist standardmäßig 6. Ein Agent mit sieben Schlüsseln kann das Limit aufbrauchen, bevor der korrekte Schlüssel erreicht wird. OpenSSH 10.6, veröffentlicht am 6. Oktober 2026, ergänzt das vorhandene sshd-Setting PubkeyAuthOptions um das Schlüsselwort max-pk-ok, geschrieben als PubkeyAuthOptions max-pk-ok:6. Damit kann der Server bis zu dieser Anzahl angebotener Schlüssel prüfen. Der Standardwert ist 6. Erst weitere Schlüssel werden auf MaxAuthTries angerechnet. Das erhöht den Grenzwert, hebt ihn aber nicht auf. Wenn das Limit erreicht ist, ändert sich die Meldung zu:
Received disconnect from 203.0.113.10 port 22:2: Too many authentication failuresWenn Sie stattdessen diese Meldung sehen, hat der Server die Sitzung beendet, bevor der korrekte Schlüssel erreicht wurde. Dieses Thema wird unter zu viele Authentifizierungsfehler behandelt. IdentitiesOnly=yes beschränkt den Versuch auf die angegebene Datei. Mit ssh-add -l listen Sie die im Agenten gespeicherten Schlüssel auf. Mit ssh-add -D löschen Sie sie, wenn sich dort über Jahre alte Schlüssel angesammelt haben. Schreiben Sie die Einstellungen anschließend auf, damit der nächste Login nicht davon abhängt, dass Sie sich an Optionen erinnern:
Host vps-prod
HostName 203.0.113.10
User deploy
IdentityFile ~/.ssh/vps-prod
IdentitiesOnly yesEs gibt noch eine Falle auf der Client-Seite. ssh verweigert die Verwendung eines privaten Schlüssels, den andere Konten auf Ihrem eigenen Rechner lesen können. ssh gibt eine Warnung aus und lädt den Schlüssel nicht. Der Schlüssel kann daher nicht für den Login verwendet werden. Erwarten Sie jedoch nicht, dass die Offering-Zeile fehlt. Wenn ssh den öffentlichen Teil bereits kennt, beispielsweise aus der danebenliegenden Datei .pub, bietet es diesen an. Der Server kann mit Server accepts key antworten. Erst danach lädt ssh den privaten Schlüssel zum Signieren, stößt auf diese Warnung und gibt den Schlüssel auf:
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: UNPROTECTED PRIVATE KEY FILE! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/home/you/.ssh/vps-prod' are too open.chmod 600 ~/.ssh/vps-prod behebt das Problem. Beim Übertragen eines Schlüssels über einen USB-Stick oder eine Windows-Freigabe gehen die Berechtigungen häufig verloren. Wo Schlüssel gespeichert werden und welche Namen sie erhalten sollten, wird unter Grundlagen der SSH-Schlüsselverwaltung erläutert.
Ursache 3: Der Public Key wurde nie in authorized_keys eingetragen
Wenn ssh -v zeigt, dass der Key gesendet wird, und der Server die Anmeldung trotzdem ablehnt, müssen Sie als Nächstes prüfen, ob dieser Key in der authorized_keys-Datei des Kontos steht. Öffnen Sie dazu die Konsole Ihres Providers, da Sie sich nicht per SSH anmelden können, um dies zu prüfen.
sudo ls -l /home/deploy/.ssh/
sudo ssh-keygen -lf /home/deploy/.ssh/authorized_keysssh-keygen -lf gibt für jede Zeile in einer authorized_keys-Datei einen Fingerabdruck aus:
256 SHA256:0eL/8sBw... you@laptop (ED25519)
3072 SHA256:9Tq2yZk... old-laptop (RSA)Vergleichen Sie diese Fingerabdrücke mit dem Fingerabdruck in Ihrer Offering public key-Zeile. Wenn Ihr Key stattdessen in einer Trying private key-Zeile ausgegeben wurde, enthält diese Zeile nur den Dateinamen. Ermitteln Sie den Fingerabdruck daher mit ssh-keygen -lf für die passende .pub-Datei. Wenn der Key nicht in der Liste steht, ist er für dieses Konto nicht installiert, unabhängig davon, was Sie zuvor getan zu haben glauben.
Vier häufige Fehlerursachen:
- Sie haben den privaten Key statt der
.pub-Datei eingefügt. Eine Public-Key-Zeile enthält zunächst einen Key-Typ wiessh-ed25519,ecdsa-sha2-nistp256oderssh-rsa, danach eine lange Base64-Zeichenfolge und optional einen Kommentar. Optionen wierestrictkönnen vor dem Key-Typ stehen. Ein privater Key beginnt mit-----BEGIN OPENSSH PRIVATE KEY-----. - Der eingefügte Text wurde auf mehrere Zeilen umgebrochen. Jeder Eintrag muss vollständig in genau einer Zeile stehen. Ein umgebrochener Key wird daher als mehrere fehlerhafte Einträge gelesen und passt zu keinem Key.
- Der Key wurde in
/root/.ssh/authorized_keyseingetragen, während Sie sich alsdeployanmelden, oder umgekehrt. Die Datei gilt jeweils für ein Konto. Es gibt keine gemeinsame Datei. - Das Feld des Providers zum Hinzufügen eines Keys hat den Key nur für den Standardbenutzer des Images eingetragen. Das später erstellte Konto hat deshalb ein leeres
.ssh-Verzeichnis.
Fügen Sie den Key sicher über die Konsole als root hinzu:
sudo install -d -m 700 -o deploy -g deploy /home/deploy/.ssh
sudo tee -a /home/deploy/.ssh/authorized_keys >/dev/null <<'EOF'
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleKeyDataHere you@laptop
EOF
sudo chown deploy:deploy /home/deploy/.ssh/authorized_keys
sudo chmod 600 /home/deploy/.ssh/authorized_keysFühren Sie anschließend erneut sudo ssh-keygen -lf /home/deploy/.ssh/authorized_keys aus. Der neue Fingerabdruck sollte nun in der Liste stehen. Von einem Computer, an dem Sie sich weiterhin mit einem Passwort anmelden können, hängt ssh-copy-id -i ~/.ssh/vps-prod.pub deploy@203.0.113.10 den Key für Sie an und erstellt .ssh und authorized_keys mit restriktiven Berechtigungen, falls diese noch nicht vorhanden sind. Die Berechtigungen eines bereits vorhandenen .ssh-Verzeichnisses oder einer bereits vorhandenen authorized_keys-Datei werden dabei nicht geändert. Prüfen Sie diese daher wie unter Ursache 4 beschrieben.
Ursache 4: Warum sshd authorized_keys ignoriert, wenn die Berechtigungen zu weit gefasst sind
StrictModes yes ist der Standardwert von sshd. Unter dieser Einstellung weigert sich sshd, authorized_keys zu lesen, wenn diese Datei, das Verzeichnis .ssh oder das Home-Verzeichnis des Kontos von einer anderen Identität als dem Eigentümer beschreibbar ist oder dem falschen Konto gehört. Der Grund ist unmittelbar: Wenn die Gruppe oder alle anderen in Ihr Home-Verzeichnis schreiben können, kann jedes Konto mit diesem Zugriff authorized_keys ersetzen und die Anmeldung übernehmen. sshd behandelt einen nicht vertrauenswürdigen Pfad so, als wäre kein Schlüssel vorhanden.
Der Client zeigt lediglich die Meldung Permission denied an. Das Server-Log enthält den tatsächlichen Grund:
Authentication refused: bad ownership or modes for directory /home/deploy/.sshOder, wenn die Datei selbst das Problem ist:
Authentication refused: bad ownership or modes for file /home/deploy/.ssh/authorized_keysWas sshd akzeptiert:
- Das Home-Verzeichnis: nicht für die Gruppe und nicht für alle anderen beschreibbar.
755,750und700werden akzeptiert.775und777werden abgelehnt. ~/.ssh: dieselbe Regel. Das sshd-Handbuch empfiehlt den Zugriff ausschließlich für den Eigentümer. Das entspricht dem Modus700.~/.ssh/authorized_keys: dieselbe Regel, außerdem muss es sich um eine reguläre Datei handeln. Wenn dies nicht der Fall ist, meldet das Log, dass der Pfadis not a regular file. Das Handbuch empfiehlt Lese- und Schreibzugriff ausschließlich für den Eigentümer. Das entspricht dem Modus600.- Eigentümerschaft: Jedes Element muss dem Konto gehören, mit dem Sie sich anmelden, oder root. Jeder andere Eigentümer führt dazu, dass die Prüfung fehlschlägt.
Die Eigentümerschaft ist ebenso wichtig wie der Modus. sshd liest authorized_keys als das Konto, mit dem Sie sich anmelden. Eine Datei, die Sie mit sudo nano erstellen und anschließend nicht zurückübertragen, bleibt daher mit dem Modus 600 im Besitz von root. Die Eigentümerprüfung wird bestanden, aber sshd kann die Datei nicht öffnen. Das Log meldet dann stattdessen, dass die Datei nicht geöffnet werden konnte. Korrigieren Sie beides gleichzeitig:
sudo chown -R deploy:deploy /home/deploy/.ssh
sudo chmod 700 /home/deploy/.ssh
sudo chmod 600 /home/deploy/.ssh/authorized_keys
sudo chmod go-w /home/deploy
ls -ld /home/deploy /home/deploy/.sshDer letzte Befehl zeigt das Ergebnis an. Für das Home-Verzeichnis benötigen Sie drwxr-xr-x oder restriktiver und für .ssh den Modus drwx------. Wenn diese Zeichenfolgen noch nicht eindeutig sind, lesen Sie zunächst wie eine Berechtigungszeichenfolge wie drwxr-xr-x zu lesen ist, bevor Sie die Modi auf einem aktiven Server ändern.
Unter Rocky Linux und AlmaLinux gehört auch SELinux (security-enhanced Linux) zu den möglichen Ursachen. Ein .ssh-Verzeichnis, das auf ungewöhnlichem Weg erstellt wurde, kann das falsche Datei-Label tragen. Dadurch verweigert sshd den Lesezugriff, obwohl die Modi korrekt aussehen. sudo restorecon -Rv /home/deploy/.ssh setzt die Labels zurück, und sudo ausearch -m avc -ts recent zeigt, ob SELinux den Zugriff verweigert hat.
Ursache 5: sshd ist so konfiguriert, dass Ihre Anmeldung abgelehnt wird
Das Lesen von /etc/ssh/sshd_config reicht auf einem aktuellen Ubuntu- oder Debian-System nicht aus. Diese Datei beginnt mit Include /etc/ssh/sshd_config.d/*.conf. OpenSSH verwendet für jede Einstellung den ersten gefundenen Wert. Eine Drop-in-Datei wie 50-cloud-init.conf wird daher vor dem restlichen Inhalt der Hauptdatei gelesen und hat Vorrang vor jeder globalen Einstellung, die Sie weiter unten ändern. Eine Ausnahme ist ein Match-Block: Im Handbuch zu sshd_config steht, dass die Einstellungen darin die Werte aus dem globalen Abschnitt überschreiben. Ein passender Match-Block hat daher Vorrang vor einer Drop-in-Datei für die Verbindungen, auf die er zutrifft, selbst wenn er am Ende der Hauptdatei steht. Die Drop-in-Dateien werden außerdem in lexikalischer Reihenfolge gelesen. Eine Datei namens 00-something.conf wird daher vor 50-cloud-init.conf gelesen. Der erste gesetzte Wert gewinnt. Deshalb kann eine Änderung korrekt aussehen und trotzdem überhaupt nichts bewirken.
Lassen Sie sich von sshd die effektive Konfiguration anzeigen, die aus all diesen Dateien erstellt wird:
sudo sshd -T | grep -Ei 'pubkeyauth|authorizedkeysfile|permitrootlogin|allowusers|allowgroups|denyusers'sshd -T startet einen neuen Testprozess, der die Dateien in ihrem aktuellen Zustand vom Datenträger liest. Der bereits laufende sshd wird dabei nicht abgefragt. Eine Änderung, die Sie noch nicht durch einen Neustart übernommen haben, wird hier deshalb angezeigt, bevor der laufende Server sie verwendet.
Eine korrekte Ausgabe sieht so aus:
permitrootlogin prohibit-password
pubkeyauthentication yes
authorizedkeysfile .ssh/authorized_keys .ssh/authorized_keys2Achten Sie in Ihrer eigenen Ausgabe auf Folgendes:
pubkeyauthentication no. Es wird niemals ein Schlüssel akzeptiert. Inssh -verscheint dies ebenfalls als ersteAuthentications that can continue:-Liste ohnepublickey.authorizedkeysfilezeigt auf einen anderen Pfad, zum Beispiel/etc/ssh/authorized_keys/%u. Ihre Datei im Home-Verzeichnis wird dann vollständig ignoriert. Für den neuen Pfad gelten stattdessen die Berechtigungsregeln aus Ursache 4.allowusersoderallowgroupsist vorhanden. Jedes nicht aufgeführte Konto wird mit genau diesem Fehler und ohne weitere Erklärung abgelehnt.denyusersunddenygroupsverhalten sich umgekehrt genauso.permitrootlogin no, während Sie versuchen, sich als root anzumelden.prohibit-passwordist die sinnvolle Zwischenlösung: root darf einen Schlüssel verwenden, aber kein Passwort.
Match-Blöcke erscheinen nicht in einer einfachen sshd -T-Ausgabe, weil ihr Ergebnis davon abhängt, wer die Verbindung herstellt. Fragen Sie eine bestimmte Verbindung ab:
sudo sshd -T -C user=deploy,host=vps.example.com,addr=198.51.100.7Eine weitere Einstellung betrifft ältere Schlüssel. OpenSSH 8.8 akzeptiert SHA-1-Signaturen (ssh-rsa) standardmäßig nicht mehr. Daher kann ein RSA-Schlüssel, der jahrelang funktioniert hat, nach einem Upgrade auf einer Seite nicht mehr funktionieren, wenn die andere Seite zu alt ist, um RSA mit SHA-256 zu verwenden. Ein aktueller Client, der mit einem solchen alten Server kommuniziert, meldet dies eindeutig:
debug1: send_pubkey_test: no mutual signature algorithmDer Schlüssel selbst ist normalerweise in Ordnung. In den Release Notes zu OpenSSH 8.8 steht, dass ssh-rsa-Schlüssel nicht ersetzt werden müssen, weil sie auf RSA/SHA-256 oder RSA/SHA-512 umgestellt werden, sobald beide Seiten dies unterstützen. Ein Upgrade der alten Seite ist daher die dauerhafte Lösung. Wenn Sie sie nicht aktualisieren können, funktioniert auch ein neuer Schlüssel, sofern die alte Seite OpenSSH 6.5 oder neuer verwendet. Diese Version hat Ed25519 eingeführt; RSA mit SHA-256 wurde erst in 7.2 hinzugefügt: ssh-keygen -t ed25519 -C "deploy@vps-prod". Installieren Sie anschließend die Datei .pub wie oben beschrieben. Eine Version älter als 6.5 unterstützt weder Ed25519 noch RSA mit SHA-256. Ein neuer Ed25519-Schlüssel hilft dort daher nicht. Wenn Sie auf der aktualisierten Seite PubkeyAcceptedAlgorithms +ssh-rsa setzen, in einem Host-Block der clientseitigen ~/.ssh/config oder in der sshd-Konfiguration des Servers, werden die alten Signaturen wieder aktiviert. Damit erhalten Sie heute Zugriff auf den Server. Betrachten Sie dies daher als Möglichkeit, den Server zu erreichen, und nicht als Abschluss der Arbeiten. Die übrigen serverseitigen Einstellungen, die Sie prüfen sollten, finden Sie unter den SSH-Server auf einem VPS härten.
So lässt sich nachweisen, dass ein privater Schlüssel zum installierten öffentlichen Schlüssel gehört
Die Ursache für viele Vermutungen bei diesem Fehler ist, dass nicht bekannt ist, ob zwei Dateien zusammengehören. Ein Befehl schafft Klarheit:
ssh-keygen -y -f ~/.ssh/vps-prodDer Befehl gibt den aus dem privaten Schlüssel abgeleiteten öffentlichen Schlüssel aus. Die Datei .pub daneben wird nicht gelesen. Daher zeigt die Ausgabe, was der private Schlüssel tatsächlich enthält, und nicht, was eine veraltete Datei .pub behauptet. Wenn der Schlüssel eine Passphrase hat, fordert der Befehl diese an. Damit wird ebenfalls bestätigt, dass Sie die Passphrase noch kennen.
ssh-keygen -lf ~/.ssh/vps-prod.pub
ssh-add -lDer erste Befehl gibt den Fingerabdruck einer öffentlichen Schlüsseldatei aus. Der zweite gibt die Fingerabdrücke aus, die Ihr Agent gespeichert hat. Vergleichen Sie nun vier Darstellungen derselben Zeichenfolge: den Fingerabdruck in der Zeile Offering public key aus ssh -v, den Fingerabdruck Ihrer Datei .pub, die Fingerabdrücke in ssh-keygen -lf auf dem Server unter authorized_keys und den Fingerabdruck im Server-Log. Die Stelle, an der die Werte nicht mehr übereinstimmen, zeigt die Fehlerquelle.
Lesen Sie das Server-Log, während die Anmeldung fehlschlägt
Der Client erhält absichtlich keine verwertbare Information. Der Server protokolliert den tatsächlichen Grund. Starten Sie eine Log-Ausgabe in der Konsolensitzung und führen Sie anschließend den fehlschlagenden Befehl ssh von Ihrem Laptop aus.
sudo journalctl -u ssh -fDas standardmäßige Ubuntu-24.04-Server-Cloud-Image installiert rsyslog standardmäßig. Das Paketmanifest führt es am 3. November 2026 auf. Daher landen dieselben Einträge dort auch in /var/log/auth.log. Die minimalen Ubuntu-24.04-Cloud-Images werden ohne rsyslog ausgeliefert. Dort gibt es standardmäßig kein auth.log, und das Journal ist die richtige Anlaufstelle. Unter Rocky Linux und AlmaLinux heißt die Unit sshd. Dieselben Einträge landen dort auch in /var/log/secure.
Setzen Sie LogLevel VERBOSE in der sshd-Konfiguration und laden Sie den Dienst neu. Danach wird bei jedem Versuch der Fingerabdruck protokolliert, den der Server tatsächlich empfangen hat:
Failed publickey for deploy from 198.51.100.7 port 49812 ssh2: ED25519 SHA256:0eL/8sBw...An dieser Zeile erkennen Sie, auf welcher Seite der Fehler liegt. Ein Ihnen bekannter Fingerabdruck bedeutet, dass Ihr Schlüssel den Server erreicht hat, dort aber abgelehnt wurde. Prüfen Sie dann die Ursachen 3, 4 und 5. Ein unbekannter Fingerabdruck bedeutet, dass Ihr Client einen anderen Schlüssel gesendet hat als beabsichtigt. Gehen Sie dann zu Ursache 2 zurück.
Wenn das Log weiterhin unklar ist, starten Sie einen zweiten sshd an einem anderen Port im Debug-Modus. Er bleibt im Vordergrund, bedient eine Verbindung, gibt seine Verarbeitungsschritte aus und beendet sich anschließend:
sudo /usr/sbin/sshd -ddd -p 2222Verbinden Sie sich aus der Konsolensitzung auf demselben Server über die Loopback-Adresse mit diesem Prozess:
ssh -p 2222 -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@127.0.0.1Über 127.0.0.1 bleibt das Netzwerk zwischen Ihnen und dem Server aus dem Test heraus. Loopback-Verkehr wird weiterhin durch den Paketfilter des Kernels geleitet. Unter Ubuntu akzeptieren die standardmäßigen ufw-Regeln jedoch sämtlichen Verkehr auf der Schnittstelle lo. Daher ist für Port 2222 keine eigene Firewall-Regel erforderlich, sofern niemand diese Standardeinstellung entfernt hat. Die Debug-Ausgabe nennt die geöffnete Datei, den verglichenen Fingerabdruck und die genaue Ablehnung, einschließlich Zeilen wie Authentication refused: bad ownership or modes for directory /home/deploy. Drücken Sie Ctrl+C, sobald Sie die Ursache gefunden haben. Der eigentliche sshd auf Port 22 bleibt währenddessen unverändert.
So vermeiden Sie, sich selbst auszusperren
Jeder Schritt, bei dem Serverkonfigurationen bearbeitet werden, erfordert einen alternativen Zugang, der nicht von SSH abhängt. Richten Sie diesen ein, solange SSH noch funktioniert, nicht erst nach einem Ausfall.
- Öffnen Sie die Konsole Ihres Anbieters über die serielle Schnittstelle oder VNC (Virtual Network Computing) und stellen Sie sicher, dass Sie sich dort anmelden können.
- Stellen Sie sicher, dass Sie ein funktionierendes lokales Passwort für ein Konto mit sudo-Rechten kennen. Falls nicht, setzen Sie zuerst das root-Passwort über die Konsole des Anbieters zurück.
- Lassen Sie Ihre aktuelle SSH-Sitzung geöffnet. Eine offene Sitzung überlebt
systemctl restart ssh; sie bleibt also ein Zugangsweg, falls die neue Konfiguration fehlerhaft ist. - Prüfen Sie die Syntax vor dem Neustart:
sudo sshd -tgibt bei einer gültigen Datei nichts aus, bei Fehlern hingegen die Datei und die Zeilennummer. - Öffnen Sie ein zweites Terminal und melden Sie sich dort neu an, bevor Sie das erste schließen. Eine fehlerhafte Konfiguration verhindert neue Anmeldungen, lässt bestehende jedoch unberührt. Die Sitzung, in der Sie sich befinden, kann Ihnen daher nicht mitteilen, ob die Änderung erfolgreich war.
Starten Sie den Dienst mit sudo systemctl restart ssh auf Debian und Ubuntu neu, oder mit sudo systemctl restart sshd auf Rocky Linux und AlmaLinux. Unter Ubuntu 24.04 wird sshd über eine Socket-Unit gestartet, deren Port und Adresse über sshd_config durch einen systemd-Generator bezogen werden. Daher erfordert eine Änderung an Port oder ListenAddress zusätzlich sudo systemctl daemon-reload und anschließend sudo systemctl restart ssh.socket, bevor sie wirksam wird.
FAQ
Warum erhalte ich „Permission denied (publickey)“, obwohl derselbe Schlüssel auf einem anderen Server funktioniert?
Der Schlüssel ist in Ordnung, aber eine Voraussetzung in seiner Umgebung ist es nicht. Führen Sie ssh -v aus und suchen Sie nach der Zeile Offering public key oder Trying private key für Ihren Schlüssel. Wenn Ihr Schlüssel in keiner der beiden Zeilen aufgeführt ist, hat ssh ihn gar nicht gesendet: Die Datei befindet sich nicht unter ~/.ssh unter einem Standardnamen und ist auch nicht im Agent geladen. Fügen Sie sie daher mit -i /path/to/key -o IdentitiesOnly=yes hinzu. Wenn der Schlüssel aufgeführt ist und der Server ihn trotzdem ablehnt, fehlt dieser Schlüssel in authorized_keys des Kontos, der Pfad dorthin ist für die Gruppe beschreibbar oder die sshd-Konfiguration blockiert den Benutzer. Das Server-Log unterscheidet diese Fälle.
Wie sehe ich, welchen Schlüssel SSH tatsächlich sendet?
ssh -v host gibt für jeden Schlüssel, dessen öffentlichen Teil es bereits kennt, eine Zeile debug1: Offering public key: mit dem Schlüsseltyp und einem SHA256-Fingerabdruck aus. Bei einem aus einer Datei gelesenen Schlüssel wird diese Datei genannt. Bei einem Schlüssel, der nur im Agent geladen ist, wird stattdessen dessen Agent-Kommentar angezeigt. agent am Ende der Zeile kennzeichnet Schlüssel, die der Agent bereitgestellt hat. Wenn die nächste Zeile send_pubkey_test: no mutual signature algorithm lautet, wurde dieser Schlüssel letztlich nicht gesendet. Für einen Schlüssel, dessen öffentlichen Teil ssh vorab nicht lesen konnte, gibt es keine Offering-Zeile. Stattdessen gibt ssh Trying private key: mit dem Dateinamen aus, lädt den privaten Schlüssel und sendet direkt eine signierte Anfrage. ssh-add -l listet die Fingerabdrücke der im Agent geladenen Schlüssel auf. ssh-keygen -lf ~/.ssh/id_ed25519.pub gibt den Fingerabdruck einer einzelnen Schlüsseldatei aus. ssh-keygen -y -f ~/.ssh/id_ed25519 gibt den öffentlichen Schlüssel aus, der tatsächlich aus einem privaten Schlüssel abgeleitet wird. Damit die Anmeldung erfolgreich ist, muss der Fingerabdruck des gesendeten Schlüssels außerdem in ssh-keygen -lf erscheinen, wenn dieser Befehl gegen authorized_keys des Servers ausgeführt wird.
Warum ignoriert sshd meine authorized_keys-Datei?
Weil StrictModes standardmäßig aktiviert ist und entweder die Datei, das Verzeichnis .ssh oder das Home-Verzeichnis für die Gruppe oder alle anderen Benutzer beschreibbar ist oder einem anderen Konto als Ihnen oder root gehört. sshd vertraut keinem Pfad, den jemand anderes ändern kann, und verhält sich daher so, als wäre kein Schlüssel vorhanden. Die Prüfung verlangt, dass keines der drei Verzeichnisse oder die Datei für die Gruppe oder andere Benutzer beschreibbar ist, dass jedes davon dem Anmeldekonto oder root gehört und dass authorized_keys eine reguläre Datei ist. Das Entfernen der Schreibrechte allein reicht daher nicht immer aus. 755 oder restriktiver für das Home-Verzeichnis, 700 für .ssh und 600 für authorized_keys, jeweils im Besitz des Anmeldekontos, ist eine sichere Einstellung. Mit LogLevel VERBOSE protokolliert der Server Authentication refused: bad ownership or modes for directory /home/deploy/.ssh.
Mein Schlüssel hat unmittelbar nach einem Server-Upgrade nicht mehr funktioniert. Was wurde geändert?
Wenn es sich um einen RSA-Schlüssel handelt, ist dies höchstwahrscheinlich auf die Änderung bei SHA-1 zurückzuführen. OpenSSH 8.8 hat ssh-rsa-SHA-1-Signaturen standardmäßig deaktiviert. Ein RSA-Schlüssel wird daher abgelehnt, wenn die Gegenseite ihn nur auf diese Weise verwenden kann. Ein aktueller Client zeigt debug1: send_pubkey_test: no mutual signature algorithm an. Der Schlüssel muss nicht ersetzt werden, wenn Sie die alte Gegenseite aktualisieren können, denn RSA-Schlüssel verwenden SHA-256 oder SHA-512, sofern beide Seiten dies unterstützen. Wenn das nicht möglich ist und die alte Seite OpenSSH 6.5 oder neuer verwendet, erzeugen Sie mit ssh-keygen -t ed25519 einen modernen Schlüssel und installieren Sie dessen .pub-Datei. Eine Version älter als 6.5 unterstützt weder Ed25519 noch RSA mit SHA-256. Ein neuer Schlüssel behebt diesen Fall daher nicht. Wenn Sie sofort Zugriff benötigen, aktiviert PubkeyAcceptedAlgorithms +ssh-rsa auf der aktualisierten Seite die alten Signaturen wieder. Entfernen Sie diese Zeile, sobald die dauerhafte Lösung umgesetzt ist.
Ich habe sshd_config bearbeitet und kann mich jetzt überhaupt nicht mehr anmelden. Wie erhalte ich wieder Zugriff?
Verwenden Sie die Konsole Ihres Providers. Diese Verbindung läuft nicht über SSH. Melden Sie sich dort mit einem lokalen Passwort an, führen Sie sudo sshd -t aus, um den Syntaxfehler und seine Zeilennummer anzuzeigen, machen Sie die Änderung rückgängig und starten Sie den Dienst neu. Führen Sie anschließend sudo sshd -T aus, um die effektiven Werte anzuzeigen, die die Dateien derzeit ergeben. Eine Datei in /etc/ssh/sshd_config.d/ kann die Hauptkonfiguration überschreiben. Der Befehl liest die Dateien erneut ein, statt den laufenden sshd abzufragen. Starten Sie den Dienst daher nach jeder weiteren Änderung neu, bevor Sie eine Anmeldung testen. Wenn Sie kein lokales Passwort haben, setzen Sie zuerst über die Konsole das root-Passwort zurück und reparieren Sie anschließend die Datei.