SSH が失敗したとき、最後の行に出るエラーはたいてい要約であって、診断ではありません——Permission denied (publickey) が教えてくれるのは、ネゴシエーションの結末であって、どこで間違ったかではありません。本当の経緯は ssh -vvv の中にあります。だからこそ人は、debug3: receive packet: type 51 のような生の断片を検索エンジンに貼り付けることになるのです。このトレースを読むのに、プロトコルを暗記する必要はありません。必要なのは、本当の疑問に答えてくれるわずかな行と、どれがノイズなのかを知ることです。
これは読み方のガイドです。各 -v レベルが何を足すか、順番に現れるフェーズ、そして立ち止まる価値のある行を読み解くための早見表です。(エラーそのもの——接続拒否、タイムアウト、ホスト鍵の警告——への対処は、エラー早見表にあります。)
-v・-vv・-vvv が実際に足すもの
-vはdebug1の行を表示します。大まかな筋書きです。どの設定ファイルが読まれたか、どこへ接続しているか、サーバーが何を提示したか、どの鍵が試されたか、どの認証方式が通ったか。たいていの問題はこれで十分です。-vvはdebug2を足します。ネゴシエーションの詳細です——双方からの完全なアルゴリズム一覧、鍵ごとの判断です。-vvvはdebug3を足します。パケットレベルのトレースで、send packet: type N/receive packet: type Nの行も含みます。プロトコルのメッセージ番号が名指しされるのはこのレベルで、検索されがちな謎めいた行が出てくるのもここです。
まずは -v から始めます。-v の筋書きが唐突に途切れ、どのパケットで息絶えたかを正確に見る必要があるときに、-vvv に手を伸ばしてください。
現れる順に見るフェーズ
成功する接続はどれも同じ道をたどり、デバッグ出力もそれに沿います。フェーズを知っていれば、何が失敗したかを理解する前に、失敗がどこで起きたかを言い当てられます。
1. 設定(Config)。 最初の行は Reading configuration data /home/you/.ssh/config と .../etc/ssh/ssh_config で、続いてマッチした Host ブロックごとに Applying options for <pattern> が出ます。SSH が、あなたの予想しないポート・ユーザー・鍵を使っているなら、その犯人はまさにここで名指しされます——忘れていたどこかのブロックが適用されているのです。(そのファイルに何を書くべきか、マッチの仕組みはどうなっているか: ~/.ssh/config ガイド(英語)。)
2. TCP 接続。 Connecting to host [1.2.3.4] port 22. のあと Connection established. が出ます。代わりに connect to address ... Connection refused や Connection timed out が見えたら、読むのをやめてください——この先には何も重要なものはありません。そもそも「この先」が存在しないからです。後述します。
3. バージョン交換。 Local version string SSH-2.0-OpenSSH_... と Remote protocol version 2.0, remote software version ...——両端が平文で自己紹介し合います。主に、古すぎるサーバーを見つけることと、そもそも sshd に到達できたかを確認することに役立ちます。
4. 鍵交換とホスト鍵。 SSH2_MSG_KEXINIT sent / received に続いて、選ばれたアルゴリズム(kex: algorithm: ...、kex: host key algorithm: ...)が出ます。そのあと、サーバーのホスト鍵があなたの known_hosts と照合されます: Host 'x' is known and matches the ED25519 host key / Found key in ~/.ssh/known_hosts:12。不一致なら、ここで大きな警告バナーとともに中断します。
5. 認証。 Authentications that can continue: publickey,password は、サーバーが受け付ける方式を列挙したものです。続いてクライアントは、方式と鍵を 1 回ずつ試していき、何かが成功するまで——あるいは何も成功しないまま——進みます。読み込みのほとんどが起きるのはこのフェーズなので、専用の早見表を用意します。
最初から最後まで、注釈つきのトレース
以下は、最もよく検索される失敗——Permission denied (publickey)——の、実際の(抜粋した)-vvv の実行結果で、重要な行に印を付けてあります。上記のすべてのフェーズが順番に見て取れます。
$ ssh -vvv deploy@203.0.113.10
OpenSSH_9.6p1, OpenSSL 3.0.13
debug1: Reading configuration data /home/you/.ssh/config
debug1: /home/you/.ssh/config line 12: Applying options for 203.0.113.10 # ← Host ブロックがマッチした。ユーザー・鍵・ポートが違うなら、まずこれを疑う
debug1: Connecting to 203.0.113.10 [203.0.113.10] port 22.
debug1: Connection established. # ← TCP は確立:接続拒否/タイムアウトはここで除外される
debug1: Local version string SSH-2.0-OpenSSH_9.6
debug1: Remote protocol version 2.0, remote software version OpenSSH_8.9p1 # ← 本物の sshd に到達できた
debug1: SSH2_MSG_KEXINIT sent
debug1: SSH2_MSG_KEXINIT received
debug1: kex: algorithm: curve25519-sha256
debug1: Server host key: ssh-ed25519 SHA256:abc123...
debug1: Host '203.0.113.10' is known and matches the ED25519 host key. # ← ホスト鍵フェーズは通過:known_hosts の問題ではない
debug1: Authentications that can continue: publickey # ← 鍵のみ:パスワードは一切提示されない
debug1: Offering public key: /home/you/.ssh/id_ed25519 ED25519 SHA256:def456... # ← クライアントが実際に試した鍵
debug3: receive packet: type 51 # ← SSH_MSG_USERAUTH_FAILURE:サーバーがその鍵を拒否した
debug1: Trying private key: /home/you/.ssh/id_rsa # ← エージェントの鍵が尽き、今度は鍵ファイルにフォールバック
debug1: No more authentication methods to try.
deploy@203.0.113.10: Permission denied (publickey).
下から上へ読んでください。失敗は Permission denied (publickey) で、その上にある最後の本物の試行は、type 51 を引き出した id_ed25519 の提示です。つまりサーバーはその鍵を見た上で拒否しました——鍵が欠けているのではなく、サーバー側の問題(ログインユーザーが違う、鍵が authorized_keys にない、あるいは ~/.ssh のパーミッション)です。もし id_ed25519 が Offering public key の行にそもそも一度も現れていなかったなら、診断はクライアント側に反転します。鍵が一度も送られていない、ということです。
早見表——本当の疑問に答える行
Will attempt key: / Offering public key: ...——「どの鍵を、どの順で試しているのか」への答えです。-v では各候補が見えます: ファイルパスまたはエージェントのエントリ、鍵の種類、フィンガープリント。あなたが意図した鍵がこの一覧になければ、サーバーはそれを一度も見ていません——サーバー側をいくら直しても無駄です。-i で明示的に指し示し、あなたの指定を上書きしている IdentityFile の行がないか、設定フェーズを確認してください。
debug3: receive packet: type 51——これは SSH_MSG_USERAUTH_FAILURE で、サーバーがその認証試行を拒否したことを表します。これ自体は致命的ではありません——クライアントは意に介さず次の鍵や方式に進むので、正常なログインでも type 51 を何度か見かけるものです。これが診断になるのは、あなたが通ると見込んでいた鍵の直後に出たときだけです。そのときサーバーはその鍵を見て「ノー」と言ったわけです——ユーザーが違う、鍵が authorized_keys にない、あるいはサーバー側のパーミッションが悪い。その切り分けは Permission denied ガイドにあります。(目安として: type 50 は送出されるリクエスト、type 52 は成功です。)
Server accepts key: のあとでそれでも失敗する——これは興味深いケースです。サーバーはこの公開鍵が authorized_keys にあると確認し、クライアントに所有の証明を求めました。この行のあとでも認証がなお失敗するなら、問題は証明のあなた側にあります: エージェントが署名できなかった(エージェントのソケットが違う、その秘密鍵を実際には保持していない)、パスフレーズの入力が失敗した、あるいはディスク上の秘密鍵が、提示された公開鍵と一致しない。直後の sign_and_send_pubkey: の行——またはそれが無いこと——を見てください。
No more authentication methods to try.——終着点です。サーバーが許可したすべての方式を使い尽くし、すぐ次の行が Permission denied です。この行をエラーとして読まないでください。ここから上へ読んで、最後の本物の試行と、それがなぜ失敗したかを見つけてください。
expecting SSH2_MSG_KEX_ECDH_REPLY でのハング——これはそもそも認証の問題ではありません。サーバーの鍵交換の応答は接続で最初の大きなパケットで、それより前がすべて動いていたのにこれが来ないなら、典型的な原因は MTU の問題か、行儀の悪い中間装置(middlebox)です——VPN や一部の企業ファイアウォールは、大きなパケットを断片化したり落としたりします。別のネットワークから、または VPN なしで試してください。それでつながるなら、鍵をにらむのではなく MTU を調整しましょう。
Unspecified GSS failure——Kerberos のノイズです。クライアントは GSSAPI 認証を試みましたが、あなたは Kerberos レルムにおらず、失敗して次の方式へフォールバックしました。接続が最終的に鍵で成功するか失敗するなら、この行は何の役割も果たしていません——実際に Kerberos の SSO を使っているのでない限り、無視してください。
connect to address ... port 22: Connection refused / Connection timed out——接続はそもそも起きなかったので、認証に関する疑問はすべて意味を失います。Refused はホストが応答したが何も待ち受けていないこと、timed out は経路上が沈黙していることを意味します。2 つの別々の調査で、どちらも鍵とは無関係です——2 分でできる切り分けが、その両方の分岐を扱っています。
素早く突き止めるワークフロー
3 つの習慣が、デバッグテキストの壁を 2 分で読めるものに変えます。
- ノイズを取り除いて再現する。
ssh -vvv -o IdentitiesOnly=yes -i ~/.ssh/the_key user@hostはちょうど 1 つの鍵だけを提示するので、トレースには 6 回ではなく 1 回の試行だけが含まれ、type 51 の意味は 1 つに定まります。 - 下から上へ読む。 末尾の失敗を見つけ、そこから上へさかのぼって、その直前の最後の判断——最後の
Offering public key、越えられなかったフェーズの境界——にたどり着きます。トレースの最初の 30 行は、ほとんどいつも健全です。 - 誰が何を設定したかを確認する。 挙動が意図と合わないとき、冒頭の
Reading configuration dataとApplying options forの行が、原因となっているファイルとブロックを名指しします。「SSH が私のフラグを無視する」の半分は、設定ブロックが静かに勝っているだけです。
そもそも読むトレースを減らす
何かが壊れたとき、トレースは正しい道具です——ですが、それが明かすことのかなりの部分は、本来あなたが再発見しなくてよいはずの状態です。このホストがどの鍵を求めているか、どのユーザーか、どのポートか。Termalin はそれらを保存したホストとともに保持するので、正しい鍵は、エージェントの並びで 4 番目に出るのではなく、狙って提示されます。そして各サーバーの身元を初回接続時に検証し、フィンガープリントが変われば大きな警告を出します——ホスト鍵フェーズを、意図して扱うわけです。ホストのライブ状態は、接続する前に「そもそもその箱に到達できるのか?」に答えてくれます。これはトレースの refused/timed-out の分岐を、丸ごと先回りして潰すものです。Free プランにホスト数の制限はありません——ダウンロードして、-vvv は本当に奇妙な日のためにとっておきましょう。
Termalin は、ホストごとのポート・ユーザー・鍵・キープアライブをホストとともに保持し、接続のたびにサーバーの身元を検証する、無料・クロスプラットフォームの SSH クライアントです。ダウンロードするか、機能の一覧をご覧ください。