Dépannage et Foire Aux Questions

Si vous rencontrez des problèmes lors de l’utilisation de PhanTerm, veuillez vous référer au guide de dépannage suivant.

1. Problèmes de Rendu du Terminal ou de Chevauchement de Texte

Symptôme : Après être entré dans le terminal, certaines applications en ligne de commande complexes (comme les applications avec de longs retours à la ligne automatiques, ou les journaux Git multicolores) présentent des décalages d’affichage, des rémanences de texte ou des positions de curseur incorrectes.

Solution de dépannage : Cela est généralement dû à une désynchronisation des dimensions de largeur et de hauteur du terminal détectées par le système d’exploitation. Veuillez essayer de redimensionner manuellement la fenêtre en la faisant glisser. La couche d’écoute de PhanTerm, après avoir reçu l’événement de changement de taille (Resize), forcera une réinitialisation des dimensions correctes vers le PTY distant, ce qui peut résoudre plus de 90 % des problèmes de désordre visuel.

2. Impossible de se Connecter au Serveur (Connection Timed Out)

Symptôme : L’animation de chargement Connecting... s’affiche en continu, suivie d’une invite de dépassement de délai (timeout) ou d’inaccessibilité du réseau.

Solution de dépannage :

1. Veuillez d’abord vérifier si l’adresse IP et le port que vous avez saisis (en particulier les ports personnalisés autres que le 22) sont corrects.
2. Confirmez que le pare-feu de la machine distante ou le groupe de sécurité de votre fournisseur de services cloud a autorisé votre adresse IP publique locale.
3. Si le serveur cible se trouve dans un environnement réseau interne, vous devrez peut-être configurer un Hôte de Rebond (ProxyJump) dans les paramètres de connexion pour le traverser.

3. Authentification par Clé SSH Refusée (Permission Denied)

Symptôme : L’authentification par clé a été configurée, mais le système demande toujours un mot de passe ou la connexion échoue.

Solution de dépannage :

1. Vérification du chemin : Vérifiez si le chemin IdentityFile que vous avez renseigné existe et est valide.
2. Vérification du format : Assurez-vous que vous avez fourni un fichier de clé privée (comme id_rsa ou id_ed25519), et non un fichier de clé publique avec le suffixe .pub.
3. Agent Système : Si vous avez choisi de vous fier au ssh-agent ou à Pageant de votre système pour la gestion, assurez-vous que ces services d’arrière-plan sont en cours d’exécution et que vos clés ont été correctement chargées dans le système via ssh-add.

4. Alerte d’Écran Rouge pour Non-correspondance de l’Empreinte de la Clé d’Hôte

Symptôme : Lors de la connexion, une forte fenêtre d’alerte rouge s’affiche, indiquant que la signature de la clé de l’hôte est incorrecte.

Solution de dépannage : Ne l’ignorez pas facilement ! Veuillez d’abord contacter l’administrateur de votre serveur. Vous ne devriez considérer cela comme normal que dans les deux cas suivants :

1. Le système d’exploitation vient d’être réinstallé.
2. L’administrateur vous a informé qu’il vient de procéder à une rotation des certificats de sécurité SSH.

S’il est confirmé que c’est sûr, vous pouvez accéder au répertoire de configuration local (voir Référence de Configuration), supprimer manuellement la ligne d’enregistrement en conflit dans known_hosts.yaml, puis réessayer.