Fehlerbehebung & FAQ

Wenn Sie bei der Verwendung von PhanTerm auf Probleme stoßen, konsultieren Sie bitte die folgende Anleitung zur Fehlerbehebung für häufig auftretende Probleme.

1. Fehler bei der Terminaldarstellung oder überlappender Text

Symptom: Nach dem Betreten des Terminals weisen einige komplexe Kommandozeilenanwendungen (wie solche mit automatischem Zeilenumbruch für lange Befehle oder mehrfarbige Git-Logs) fehlerhafte Anzeigen, Text-Artefakte oder falsche Cursorpositionen auf.

Fehlerbehebung: Dies wird normalerweise durch eine Asynchronität zwischen den vom Betriebssystem erkannten Abmessungen des Terminals verursacht. Bitte versuchen Sie, die Fenstergröße manuell durch Ziehen anzupassen. Nachdem die Überwachungsschicht von PhanTerm ein Fenster-Resize-Ereignis (Resize) empfangen hat, wird sie das Remote-PTY zwingen, die korrekten Dimensionen zurückzusetzen. Dies löst über 90 % der Anzeigeprobleme.

2. Verbindung zum Server kann nicht hergestellt werden (Connection Timed Out)

Symptom: Die Ladeanimation Connecting... wird kontinuierlich angezeigt, gefolgt von einer Fehlermeldung bezüglich einer Zeitüberschreitung oder Unerreichbarkeit des Netzwerks.

Fehlerbehebung:

1. Bitte überprüfen Sie zunächst, ob die von Ihnen eingegebene IP-Adresse und der Port (insbesondere bei von 22 abweichenden, benutzerdefinierten Ports) korrekt sind.
2. Bestätigen Sie, dass die Firewall des Remote-Rechners oder die Sicherheitsgruppe des Cloud-Anbieters Ihre lokale öffentliche IP-Adresse zulässt.
3. Wenn sich der Zielserver in einem internen Netzwerk befindet, müssen Sie möglicherweise einen Bastion-Host (ProxyJump) in den Verbindungseinstellungen konfigurieren.

3. SSH-Schlüsselauthentifizierung abgelehnt (Permission Denied)

Symptom: Die Schlüsselauthentifizierung ist konfiguriert, Sie werden jedoch weiterhin zur Eingabe eines Passworts aufgefordert oder die Verbindung schlägt fehl.

Fehlerbehebung:

1. Pfad überprüfen: Überprüfen Sie, ob der von Ihnen eingegebene IdentityFile-Pfad existiert und gültig ist.
2. Formatprüfung: Stellen Sie sicher, dass Sie eine private Schlüsseldatei angeben (wie id_rsa oder id_ed25519) und keine öffentliche Schlüsseldatei mit der Endung .pub.
3. System-Agent: Wenn Sie sich für die Verwaltung auf ssh-agent oder Pageant des Systems verlassen, stellen Sie sicher, dass diese Hintergrunddienste ausgeführt werden und dass Ihre Schlüssel über ssh-add korrekt in das System geladen wurden.

4. Roter Warnbildschirm für nicht übereinstimmende Host-Schlüssel-Fingerabdrücke

Symptom: Beim Verbindungsaufbau erscheint eine markante rote Warnung, die darauf hinweist, dass die Signatur des Hostschlüssels fehlerhaft ist.

Fehlerbehebung: Einfach so ignorieren sollten Sie das nicht! Bitte kontaktieren Sie zuerst Ihren Serveradministrator. Nur in den folgenden zwei Fällen sollten Sie dies als normal betrachten:

1. Das Betriebssystem wurde gerade neu installiert.
2. Der Administrator hat Ihnen mitgeteilt, dass die SSH-Sicherheitszertifikate kürzlich rotiert wurden.

Wenn Sie die Sicherheit bestätigt haben, können Sie in Ihr lokales Konfigurationsverzeichnis wechseln (siehe Konfigurationsreferenz), den entsprechenden Konflikteintrag in der known_hosts.yaml manuell löschen und es erneut versuchen.