トラブルシューティングとよくある質問

PhanTerm のご利用中に問題が発生した場合は、以下のよくある問題のトラブルシューティングガイドをご参照ください。

1. ターミナルの表示崩れや文字の重なり

症状：ターミナルに入った後、複雑なコマンドラインアプリケーション（長いコマンドで自動的に折り返されるものや、複数色を使用する Git ログなど）で、表示位置のずれ、文字の残像、またはカーソル位置の誤りが発生する。

解決方法： これは通常、オペレーティングシステムが検出しているターミナルの縦横のサイズが同期していないために発生します。ウィンドウのサイズを手動で少しドラッグして調整してみてください。PhanTerm のリスナー層はウィンドウサイズの変更 (Resize) イベントを受け取ると、リモートの PTY に対して正しいサイズのリセットを強制的に送信します。これにより、90% 以上の表示崩れの問題が解決されますので、お試しください。

2. サーバーに接続できない (Connection Timed Out)

症状：Connecting... の読み込みアニメーションがずっと表示され、その後タイムアウトやネットワーク到達不能のメッセージが表示される。

解決方法：

1. まず、入力した IP とポート（特に 22 以外のカスタムポートの場合）が正しいかご確認ください。
2. リモートマシンのファイアウォール、またはクラウドプロバイダーのセキュリティグループで、ローカルのパブリック IP が許可されていることをご確認ください。
3. ターゲットサーバーがイントラネット環境にある場合、接続設定で踏み台サーバー (ProxyJump) を設定して透過接続を行う必要がある場合があります。

3. SSH 鍵認証が拒否される (Permission Denied)

症状：鍵認証を設定しているにもかかわらず、依然としてパスワードの入力が求められるか、接続が失敗する。

解決方法：

1. パスの確認：入力した IdentityFile パスが存在し、有効であるかをご確認ください。
2. フォーマットの確認：指定したファイルが、.pub 拡張子の公開鍵ファイルではなく、秘密鍵ファイル（例: id_rsa や id_ed25519）であることをご確認ください。
3. システム Agent：システムの ssh-agent や Pageant を利用して管理している場合、これらのバックグラウンドサービスが実行されており、ssh-add コマンドを通じて鍵がシステムに正しく読み込まれているかをご確認ください。

4. ホストキーの指紋不一致による赤い警告画面

症状：接続時に、ホストキーの署名が誤っていることを示す強力な赤い警告ダイアログがポップアップ表示される。

解決方法： 安易に通過させないでください！まずはサーバー管理者にご連絡ください。これが正常であると判断すべきなのは、以下の2つの状況のみです：

1. オペレーティングシステムが再インストールされたばかりである。
2. 管理者から、SSH セキュリティ証明書をローテーションしたばかりであると通知を受けている。

安全性が確認できた場合、ローカルの設定ディレクトリ（設定リファレンスを参照）にアクセスし、known_hosts.yaml 内の該当する競合行の記録を手動で削除してから、再度お試しください。