Terminal
Free & PremiumDie Seite Terminal verwaltet, was deine Shell auf dem Mac ausmacht: Shell-Aliases, den Prompt, SSH-Keys, SSH-Host-Kürzel und die Known Hosts. Du pflegst alles hier in einer Oberfläche, und jedes neue Terminalfenster nutzt es, ohne dass du Dotfiles von Hand bearbeitest. Oben auf der Seite steht die Karte WebDonkey CLI für die Kommandozeile wd.
Was du hier machst
- Prüfen, ob dein Terminal die Kommandozeile
wdfindet, und zur Befehlsübersicht springen: CLI (wd) - Kürzel wie
gsfürgit status -sbanlegen, an- und abschalten oder aus deiner Shell übernehmen: Shell-Aliases - Die Befehlszeile aus Bausteinen gestalten, mit Live-Vorschau: Prompt
- Schlüsselpaare erzeugen, den öffentlichen Schlüssel kopieren, alte Schlüssel löschen: SSH-Keys
- Server-Kürzel für
ssh meinserveranlegen und den Schlüssel auf dem Server eintragen: SSH-Hosts - Veraltete Server-Fingerprints nach einem Serverumzug entfernen: Known Hosts
Aufbau der Seite
Die Seite hat zwei Reiter:
| Reiter | Inhalt |
|---|---|
| Shell & SSH | von oben nach unten die Karten WebDonkey CLI, Shell-Aliases, SSH-Keys, SSH-Hosts und Known Hosts. Known Hosts ist eingeklappt, die Zahl in Klammern nennt die Einträge. Ein Klick auf die Überschrift klappt sie auf. |
| Prompt | der Designer für deine Befehlszeile mit In Verwendung, Meine Prompts, Vorlagen und der Vorschau |
WebDonkey merkt sich für die laufende Sitzung, welcher Reiter offen war. Über ⌘K findest du beide Reiter direkt, etwa mit dem Suchwort „prompt“.
Schlägt eine Aktion auf dem Reiter Shell & SSH fehl, erscheint die Meldung als rot umrandete Zeile über den Karten. Ein Klick darauf blendet sie aus.
Was im Hintergrund passiert
WebDonkey schreibt nie in deine handgeschriebenen Zeilen. Es erzeugt eigene Dateien und bindet sie über klar markierte Blöcke ein:
- Aliases und Prompt liegen als Dateien im Ordner
~/Library/Application Support/WebDonkey/config/(aliases.shundprompt.sh). Ein markierter Block in~/.zshrclädt sie, und in~/.bashrc, wenn du diese Datei hast. Fehlt~/.zshrc, legt WebDonkey sie an. - Die SSH-Host-Kürzel stehen in
~/.ssh/config.d/webdonkey. Ein markierterInclude-Block ganz oben in~/.ssh/configbindet sie ein. Der Rest deiner~/.ssh/configbleibt, wie er ist. - SSH-Keys erzeugt WebDonkey mit
ssh-keygendirekt in~/.ssh.
Änderungen wirken in neuen Terminalfenstern sofort. In einem schon offenen Fenster lädst du sie mit source ~/.zshrc oder exec zsh nach. Entfernst du WebDonkey mit wd uninstall, nimmt es die markierten Blöcke wieder heraus.
Passende Versionen in der Shell
Die Einstellung Tools im Terminal (Einstellungen › Sites & Dienste) legt kleine Weiterleitungen für php, composer, node, npm, npx, mysql, mysqldump, psql, pg_dump, redis-cli und weitere Werkzeuge in deinen PATH. Sie zeigen auf die Versionen, die WebDonkey verwaltet, und lösen je Ordner auf: Im Ordner einer Site mit eigener PHP-Version ist php genau diese Version, sonst die aktive. Über denselben Weg landet auch wd in deinem PATH.
PHP im Terminal nutzt dieselbe php.ini wie der Webserver, ein php bin/console cache:clear hat also dasselbe memory_limit wie deine Webanfragen. Composer läuft ohne Speichergrenze. Setzt du selbst PHPRC oder PHP_INI_SCAN_DIR, lässt WebDonkey diese Werte stehen. Mehr dazu unter Sites & Dienste.
Free und Premium
Alles auf dieser Seite ist kostenlos. Einzige Grenze: Im Free-Tarif behältst du 3 eigene Prompts. Die acht Vorlagen im Reiter Prompt zählen nicht mit.
Shell-Aliases Free
Ein Alias ist ein Kürzel für einen längeren Befehl: Du tippst gs, die Shell führt git status -sb aus. Mit Shell-Aliases pflegst du diese Kürzel in einer Liste statt in deiner .zshrc. WebDonkey schreibt sie in eine eigene Datei, die deine Shell beim Start lädt.
So findest du es
Seitenleiste Werkzeuge › Terminal, Reiter Shell & SSH, Karte Shell-Aliases.
So gehst du vor
- Klicke auf Neuer Alias.
- Trag bei Name das Kürzel ein, zum Beispiel
gs. - Trag bei Befehl den Befehl ein, zum Beispiel
git status -sb. - Klicke auf Speichern oder drück Enter im Feld Befehl. Der Alias steht in der Liste.
- Ist das Kästchen In Shell laden oben rechts noch aus, schalte es ein. Erst dann lädt deine Shell die Aliases.
- Öffne ein neues Terminalfenster und tippe
gs.
Einen Alias aus deiner Shell übernehmen
Unter der Liste steht In deiner Shell erkannt mit der Zahl der Treffer. Das sind Aliases, die deine Shell schon kennt, auch aus Plugin-Sammlungen wie oh-my-zsh, die WebDonkey aber noch nicht verwaltet.
- Klicke auf In deiner Shell erkannt, um die Liste aufzuklappen.
- Klicke in der Zeile des Alias auf Importieren.
Der Alias erscheint in deiner Liste (sie ist nach Namen sortiert) und ist eingeschaltet. Das Original in deinen Dotfiles bleibt unangetastet. Der Block von WebDonkey steht beim Einschalten am Ende deiner .zshrc, bei gleichem Namen gilt deshalb in der Regel der verwaltete Alias.
Bearbeiten, abschalten, löschen
- Kästchen vor der Zeile: nimmt den Alias in die generierte Datei auf oder lässt ihn weg, ohne ihn zu löschen. Ein abgeschalteter Alias ist durchgestrichen.
- Stift: öffnet Alias bearbeiten mit Name und Befehl.
- Papierkorb: fragt Alias löschen? und entfernt ihn nach Löschen aus der generierten Datei.
Felder und Optionen
| Element | Bedeutung |
|---|---|
| In Shell laden | an: Ein markierter Block in ~/.zshrc (und in ~/.bashrc, falls vorhanden) lädt die Alias-Datei. aus: Der Block ist entfernt, deine Aliases bleiben gespeichert, wirken aber nicht. Ein gelber Hinweis erinnert dich daran. |
| Name | das Kürzel. Erlaubt sind Buchstaben, Ziffern und die Zeichen _, -, . und :, höchstens 64 Zeichen. |
| Befehl | der Befehl, für den das Kürzel steht. Er darf nicht leer sein. |
Solange die Liste leer ist, nennt sie die Klassiker gs, gl und ll als Anregung.
Was im Hintergrund passiert
- WebDonkey speichert die Aliases in seiner eigenen Datenbank und schreibt bei jeder Änderung die Datei
~/Library/Application Support/WebDonkey/config/aliases.shneu. Darin stehen nur die eingeschalteten Aliases. Von Hand geänderte Zeilen in dieser Datei werden überschrieben. - In Shell laden hängt ans Ende von
~/.zshrceinen Block zwischen# >>> WebDonkey aliases >>>und# <<< WebDonkey aliases <<<an, der die Datei lädt. Fehlt~/.zshrc, legt WebDonkey sie an.~/.bashrcbekommt den Block nur, wenn es die Datei schon gibt. Schaltest du In Shell laden aus, nimmt WebDonkey genau diesen Block wieder heraus. - Für In deiner Shell erkannt fragt WebDonkey eine interaktive Shell nach ihren Aliases. Deshalb dauert das Laden der Seite einen Moment.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Der Alias wirkt im offenen Terminal nicht | Die Shell hat ihre Startdatei vor der Änderung gelesen | source ~/.zshrc ausführen oder ein neues Fenster öffnen |
| Gelber Hinweis, die Aliases seien nicht aktiv | In Shell laden ist aus | Das Kästchen einschalten |
Meldung invalid alias name |
Der Name enthält Leerzeichen oder andere Zeichen | Nur Buchstaben, Ziffern, _, -, . und : verwenden |
| Der Alias macht etwas anderes als erwartet | Eine Zeile nach dem WebDonkey-Block in deiner .zshrc definiert denselben Namen noch einmal |
Den doppelten Alias in deiner .zshrc entfernen |
Siehe auch
Prompt Free & Premium
Der Prompt ist der Text links vor deinem Cursor im Terminal, etwa Ordner, Git-Branch und ein ❯. Im Reiter Prompt setzt du ihn aus Bausteinen zusammen, ohne Escape-Codes zu schreiben, und siehst das Ergebnis sofort in der Vorschau. WebDonkey erzeugt daraus den Shell-Code für zsh und bash.
So findest du es
Seitenleiste Werkzeuge › Terminal, Reiter Prompt. Über ⌘K kommst du mit dem Suchwort „prompt“ direkt dorthin.
So gehst du vor
Eine Vorlage verwenden
- Such dir unter Vorlagen einen Entwurf aus. Jede Karte zeigt eine kleine Vorschau.
- Klicke auf Verwenden. Die Meldung Prompt gewechselt. bestätigt den Wechsel, die Karte trägt In Verwendung.
- Öffne ein neues Terminalfenster. In einem schon offenen Fenster führst du
exec zshaus.
Es gibt acht Vorlagen: Rahmen, Minimal, Pfeil, Klammern, Statuszeile, Abgerundet, Klassisch und Zeitstempel.
Einen eigenen Prompt bauen
- Klicke unter Meine Prompts auf Neu, oder bei einer Vorlage auf Anpassen. Rechts öffnet sich der Editor Neuer Prompt.
- Gib bei Name einen Namen ein, zum Beispiel „Mein Prompt“.
- Füge mit Teil hinzufügen Bausteine an. Jede Zeile des Prompts hat ihre eigene Auswahl.
- Klicke einen Teil in der Zeile an, um ihn zu ändern. Darunter erscheinen seine Einstellungen.
- Klicke auf Speichern und verwenden. Der Prompt steht unter Meine Prompts und ist aktiv.
Speichern legt den Prompt nur ab, ohne ihn zu aktivieren.
Felder und Optionen
Die Bausteine
| Teil | Zeigt | Einstellung |
|---|---|---|
| Text | festen Text, bis zu 40 Zeichen | Text, dazu Zeichen mit Rahmen- und Pfeilzeichen wie ╔═, ┌─ oder ❯ |
| Ordner | den aktuellen Ordner | Anzeige: Ganzer Pfad (~/Sites/shop), Letzte zwei Ordner (Sites/shop) oder Nur Ordnername (shop) |
| Benutzer | deinen Benutzernamen | |
| Rechner | den Namen des Macs | |
| Uhrzeit | die Uhrzeit beim Anzeigen des Prompts | Stunden und Minuten (14:05) oder Mit Sekunden (14:05:09) |
| Datum | das Datum | 30-09-2026, 30.09.2026 oder 2026-09-30 |
| Git-Branch | den Branch, nur in einem Git-Repository | Vorlage ({branch} = Name des Branches), etwa ({branch}). {branch} muss genau einmal vorkommen, andere geschweifte Klammern sind nicht erlaubt. |
| Ergebnis | ob der letzte Befehl geklappt hat | Symbol bei Erfolg, Symbol bei Fehler, Anzeige: Nur Symbol oder Symbol und Exit-Code |
| $ oder # | das Eingabezeichen: #, wenn du als root arbeitest, sonst das übliche Zeichen der Shell (% in zsh, $ in bash) |
Für jeden Teil
- Farbe: eine der 256 Terminalfarben oder Standard des Terminals. Beim Teil Ergebnis wählst du Farbe bei Erfolg und Farbe bei Fehler getrennt.
- Fett: setzt den Teil fett.
- Leerzeichen danach: fügt nach dem Teil ein Leerzeichen ein.
- Nach links, Nach rechts: verschiebt den Teil in der Zeile.
- Teil entfernen: löscht den Teil.
Zeilen und Vorschau
- Zeile hinzufügen legt eine weitere Zeile an, Zeile entfernen löscht sie. Ein Prompt hat 1 bis 4 Zeilen mit je 1 bis 12 Teilen.
- Die Vorschau zeigt den Prompt wie im Terminal. Mit Letzter Befehl fehlgeschlagen und In einem Git-Repository siehst du, wie er in diesen Fällen aussieht.
- Shell-Code zeigt die Datei, die deine
.zshrcund.bashrcladen. WebDonkey schreibt sie bei jeder Änderung neu.
Meine Prompts und In Verwendung
- Jede Karte unter Meine Prompts hat Verwenden, Bearbeiten (Stift), Duplizieren und Löschen.
- In Verwendung oben nennt den aktiven Entwurf oder Dein eigener Prompt aus ~/.zshrc.
- Eigenen verwenden schaltet den Entwurf von WebDonkey ab, dein eigener Prompt aus der
.zshrcgilt wieder. - Löschst du den aktiven Prompt (Prompt löschen?), kommt ebenfalls dein eigener Prompt zurück.
Was im Hintergrund passiert
- Der aktive Entwurf wird zur Datei
~/Library/Application Support/WebDonkey/config/prompt.sh. Ein markierter Block am Ende von~/.zshrclädt sie (und am Ende von~/.bashrc, wenn es die Datei gibt). Weil er am Ende steht, gewinnt er gegen einPROMPT=…weiter oben in derselben Datei. - Eigenen verwenden entfernt diesen Block wieder. Deine eigenen Zeilen in der
.zshrcfasst WebDonkey nie an. - Texte aus deinem Entwurf landen sicher im Shell-Code: Zeichen wie
$, Backticks oder%bleiben wörtlich stehen und werden nicht ausgeführt.
Free und Premium
Die acht Vorlagen sind für alle kostenlos und zählen nicht mit. Im Free-Tarif behältst du 3 eigene Prompts, ein Zähler neben Neu zeigt den Stand. Ist die Grenze erreicht, sind Neu, Anpassen und Duplizieren gesperrt. Mit Premium gibt es keine Grenze.
Nach einem Wechsel von Premium zu Free bleiben alle deine Prompts erhalten. Die über der Grenze sind gesperrt: Du kannst sie umbenennen und löschen, aber nicht verwenden oder ändern, bis Premium wieder aktiv ist.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Gelber Hinweis, Powerlevel10k, Starship, Oh My Posh, Spaceship oder Pure baue einen eigenen Prompt | Diese Werkzeuge setzen den Prompt bei jedem Befehl neu und gewinnen gegen WebDonkey | Den Eintrag aus deiner .zshrc entfernen oder auskommentieren, dann exec zsh |
| Der neue Prompt erscheint nicht | Das Terminalfenster war schon offen | exec zsh ausführen oder ein neues Fenster öffnen |
Meldung, die Git-Vorlage brauche {branch} |
{branch} fehlt oder es stehen weitere geschweifte Klammern in der Vorlage |
Die Vorlage auf genau ein {branch} ohne weitere Klammern ändern |
| Meldung, ein Textteil dürfe nicht leer sein | Ein Teil Text hat keinen Inhalt | Text eintragen oder den Teil entfernen |
Siehe auch
SSH-Keys Free
Ein SSH-Key ist ein Schlüsselpaar: Der private Teil bleibt auf deinem Mac, den öffentlichen Teil hinterlegst du auf dem Server, bei GitHub oder im Panel deines Hosters. Danach meldest du dich ohne Passwort an. SSH-Keys zeigt die Schlüsselpaare in ~/.ssh, erzeugt neue und kopiert den öffentlichen Teil.
So findest du es
Seitenleiste Werkzeuge › Terminal, Reiter Shell & SSH, Karte SSH-Keys.
So gehst du vor
Einen Key erzeugen
- Klicke auf Neuer Key.
- Trag bei Dateiname einen Namen ein. Vorgabe ist
id_ed25519. - Wähle den Typ:
ed25519(kurz und modern, für fast alle Server richtig) oderRSA 4096(für ältere Server, die ed25519 nicht kennen). - Trag bei Kommentar ein, woran du den Key später erkennst, üblich ist
du@rechner. - Setz bei Bedarf eine Passphrase (optional). Leer heißt keine Passphrase. WebDonkey speichert sie nicht.
- Klicke auf Speichern. Während der Erzeugung steht auf dem Knopf Erzeuge….
Den öffentlichen Schlüssel weitergeben
- Klicke in der Zeile des Keys auf Public Key kopieren. Der Knopf zeigt kurz Kopiert.
- Füge den Text dort ein, wo der Server ihn erwartet: in
~/.ssh/authorized_keysauf dem Server, in den SSH-Einstellungen von GitHub oder im Panel deines Hosters.
Für eigene Server geht es bequemer: Leg einen SSH-Host mit diesem Key an, WebDonkey bietet dann Schlüssel eintragen an.
Einen Key löschen
- Klicke auf den Papierkorb in der Zeile.
- Die Rückfrage SSH-Key löschen? nennt den Namen. Bestätige mit Löschen.
Das löscht beide Hälften des Paars aus ~/.ssh. Server, die nur diesem Key vertrauen, sind danach nicht mehr erreichbar. Das lässt sich nicht rückgängig machen.
Felder und Optionen
| Spalte oder Feld | Bedeutung |
|---|---|
| Name | der Dateiname in ~/.ssh |
| Typ-Marke | zum Beispiel ed25519 oder rsa |
| nur Public Key | zu diesem Key fehlt die private Datei. Du kannst ihn weitergeben, dich aber nicht damit anmelden. |
| Fingerprint | die Kurzform des Schlüssels, wie ssh-keygen -l sie zeigt. Fehlt sie, steht dort der Kommentar. |
| Dateiname | Buchstaben, Ziffern, _, - und ., höchstens 64 Zeichen, nicht mit einem Punkt am Anfang |
| Typ | ed25519 oder RSA 4096 |
| Kommentar | freier Text, steht am Ende des öffentlichen Schlüssels |
| Passphrase (optional) | schützt die private Datei. ssh fragt sie ab, wenn du den Key nutzt. |
Ist ~/.ssh leer, steht dort Keine SSH-Keys in ~/.ssh gefunden.
Was im Hintergrund passiert
- Die Liste zeigt jede
.pub-Datei in~/.sshund prüft, ob die private Datei daneben liegt. - Neuer Key ruft
ssh-keygenauf und legt~/.ssh/<Dateiname>und~/.ssh/<Dateiname>.puban. Fehlt der Ordner~/.ssh, legt WebDonkey ihn mit den Rechten700an. - Gibt es schon eine Datei mit diesem Namen, bricht WebDonkey ab, statt sie zu überschreiben.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
a key with this name already exists |
In ~/.ssh liegt schon eine Datei mit diesem Namen |
Einen anderen Dateiname wählen |
invalid key name |
Der Name enthält Leerzeichen, / oder beginnt mit einem Punkt |
Nur Buchstaben, Ziffern, _, - und . verwenden |
| Ein Key fehlt in der Liste | Zu ihm gibt es keine .pub-Datei |
Mit ssh-keygen -y -f ~/.ssh/<name> > ~/.ssh/<name>.pub die öffentliche Datei neu erzeugen |
Siehe auch
SSH-Hosts Free
Mit SSH-Hosts legst du Kürzel für deine Server an. Danach genügt ssh webserver-prod statt ssh -p 2222 -i ~/.ssh/id_ed25519 deploy@203.0.113.10. Alles, was auf der SSH-Konfiguration aufbaut, nutzt das Kürzel mit: scp, rsync, git und die Remote-Funktionen vieler Editoren.
So findest du es
Seitenleiste Werkzeuge › Terminal, Reiter Shell & SSH, Karte SSH-Hosts.
So gehst du vor
- Klicke auf Neuer Host.
- Füll die Felder aus (siehe unten). Alias und Hostname / IP sind Pflicht.
- Klicke auf Speichern. Der Host steht als
ssh <alias>in der Liste, daneben Benutzer, Adresse, Port (wenn nicht 22) und Key. - WebDonkey prüft gleich danach die Anmeldung per Schlüssel. Das Ergebnis steht über der Liste.
- Öffne ein neues Terminalfenster und tippe
ssh <alias>.
Den Schlüssel auf dem Server eintragen
Kennt der Server deinen öffentlichen Schlüssel noch nicht, aber erlaubt eine Anmeldung per Passwort, öffnet sich der Dialog Der Server kennt diesen Schlüssel noch nicht:
- Ist der Server noch nicht in
~/.ssh/known_hosts, zeigt der Dialog den Fingerprint seines Host-Keys. Vergleiche ihn mit dem, den dein Hoster nennt, und hak Der Fingerabdruck stimmt, diesem Server vertrauen an. - Gib bei Passwort von … einmal das Passwort des Benutzers ein.
- Klicke auf Schlüssel eintragen.
WebDonkey trägt den öffentlichen Schlüssel in ~/.ssh/authorized_keys auf dem Server ein, wie ssh-copy-id, und prüft die Anmeldung danach erneut. Danach meldet WebDonkey über der Liste, dass die Anmeldung per Schlüssel funktioniert. Das Passwort wird nicht gespeichert. Unter Lieber selbst im Terminal? Das hier macht dasselbe: steht der passende Befehl zum Kopieren.
Bearbeiten und löschen
- Stift: öffnet Host bearbeiten. Änderst du Adresse, Benutzer, Port oder Key, prüft WebDonkey die Anmeldung erneut.
- Papierkorb: fragt Host-Kürzel löschen? und entfernt den Host nach Löschen. Danach funktioniert
ssh <alias>nicht mehr.
Felder und Optionen
| Feld | Bedeutung | Vorgabe |
|---|---|---|
| Alias | das Kürzel, das du tippst, zum Beispiel webserver-prod |
leer, Pflicht |
| Hostname / IP | Adresse des Servers, zum Beispiel example.com |
leer, Pflicht |
| Benutzer (optional) | der Login, zum Beispiel deploy. Leer: ssh nimmt deinen Mac-Benutzernamen. |
leer |
| Port | SSH-Port des Servers | 22 |
| SSH-Key (optional) | einer deiner SSH-Keys mit privater Datei. ssh-Standard überlässt die Wahl ssh. | ssh-Standard |
Ergebnis der Schlüsselprüfung
| Meldung | Bedeutung |
|---|---|
| Schlüssel funktioniert: „ssh …“ meldet sich ohne Passwort an. | alles bereit, die Meldung verschwindet nach ein paar Sekunden |
| Für „…“ ist kein Schlüssel hinterlegt: ssh fragt bei jeder Anmeldung nach dem Passwort. | du hast ssh-Standard gewählt, WebDonkey prüft dann nicht |
| Der Host ist gespeichert, aber die Anmeldung per Schlüssel ließ sich nicht prüfen: … | der Grund steht dahinter, etwa ein nicht erreichbarer Server. Der Host bleibt gespeichert. |
Was im Hintergrund passiert
- WebDonkey schreibt alle Hosts in die Datei
~/.ssh/config.d/webdonkey(Rechte600) und schreibt sie bei jeder Änderung neu. Von Hand geänderte Zeilen darin werden überschrieben. - Ganz oben in
~/.ssh/configsteht ein markierter Block (# >>> WebDonkey ssh config >>>) mit einerInclude-Zeile auf diese Datei. Er muss oben stehen, sonst würde ssh ihn nur innerhalb eines anderenHost-Abschnitts lesen. Der Rest deiner~/.ssh/configbleibt Zeichen für Zeichen erhalten. - Löschst du den letzten Host, entfernt WebDonkey Datei und Block wieder.
- Für Schlüssel eintragen meldet sich WebDonkey einmal mit Passwort an und ergänzt
~/.ssh/authorized_keysauf dem Server.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Der Schlüsselpfad enthält einen Zeilenumbruch oder ein Anführungszeichen. Wähle die Schlüsseldatei noch einmal aus. | Ein solcher Pfad könnte eine eigene Zeile in die SSH-Konfiguration schreiben, WebDonkey lehnt ihn ab | Den Key in der Liste neu wählen |
ssh <alias> kennt den Host nicht |
Das Terminal hat die Konfiguration vor dem Speichern gelesen, oder dein eigener Host-Abschnitt mit demselben Namen steht im Weg |
Neu verbinden. Doppelte Einträge in ~/.ssh/config entfernen. |
| ssh warnt vor einer geänderten Identität | Der Server wurde neu aufgesetzt | Den alten Eintrag unter Known Hosts entfernen |
| ssh fragt trotz Key nach dem Passwort | Der öffentliche Schlüssel liegt nicht auf dem Server | Den Host bearbeiten und speichern, dann im Dialog Schlüssel eintragen |
Siehe auch
Known Hosts Free
Beim ersten Kontakt mit einem Server merkt sich ssh dessen Fingerprint in ~/.ssh/known_hosts. Ändert er sich später, verweigert ssh die Verbindung, weil es einen Angriff nicht ausschließen kann. Known Hosts zeigt diese Datei lesbar und entfernt einzelne Einträge, ohne dass du Zeilen von Hand suchst.
So findest du es
Seitenleiste Werkzeuge › Terminal, Reiter Shell & SSH, ganz unten die Karte Known Hosts. Sie ist eingeklappt, die Zahl in Klammern nennt die Einträge. Ein Klick auf die Überschrift klappt sie auf.
So gehst du vor
Der häufigste Fall: Ein Server wurde neu aufgesetzt oder ist umgezogen, und ssh meldet REMOTE HOST IDENTIFICATION HAS CHANGED.
- Klapp Known Hosts auf.
- Such den Eintrag des Servers. Jede Zeile zeigt die Adresse (oder gehashter Eintrag) und den Typ des Host-Keys.
- Klicke auf den Papierkorb in der Zeile.
- Bestätige Eintrag entfernen? mit Löschen.
- Verbinde dich neu. ssh fragt jetzt wieder nach dem Fingerprint des Servers.
Prüfe den neuen Fingerprint, bevor du ihn bestätigst, besonders wenn du den Server nicht selbst neu aufgesetzt hast. Eine geänderte Kennung kann auch bedeuten, dass sich jemand dazwischenschaltet.
Felder und Optionen
| Element | Bedeutung |
|---|---|
| Adresse | der Host, wie er in der Datei steht, zum Beispiel example.com,203.0.113.10 oder [example.com]:2222 |
| gehashter Eintrag | ssh hat die Adresse unkenntlich gespeichert (Option HashKnownHosts). Welcher Server dahintersteht, zeigt ssh-keygen -F <adresse> im Terminal. |
| Typ-Marke | der Typ des Host-Keys, zum Beispiel ssh-ed25519 |
Ist die Datei leer, steht dort ~/.ssh/known_hosts ist leer.
Was im Hintergrund passiert
- Vor dem Entfernen sichert WebDonkey die ganze Datei als
~/.ssh/known_hosts.old, so wiessh-keygen -Res tut. Bei jedem Entfernen wird diese Sicherung neu geschrieben. - WebDonkey prüft vor dem Löschen, ob in der Zeile noch derselbe Host steht. Hat sich die Datei in der Zwischenzeit geändert, bricht es ab, statt die falsche Zeile zu löschen.
- Die Verbindungen auf der Seite Remote merken sich ihre Server-Fingerprints getrennt davon. Diese Liste betrifft nur das ssh in deinem Terminal.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
Meldung, known_hosts habe sich geändert (known_hosts changed on disk) |
Die Datei wurde geändert, nachdem die Seite sie gelesen hat | Die Seite neu öffnen und den Eintrag noch einmal entfernen |
| ssh meldet nach dem Entfernen weiter eine geänderte Identität | Für den Server gibt es mehrere Einträge, etwa für Name und IP | Auch die übrigen Einträge des Servers entfernen |