Когда SSH падает, ошибка в последней строке — обычно итог, а не диагноз: Permission denied (publickey) сообщает исход переговоров, а не то, где они пошли не так. Настоящая история — в ssh -vvv, и поэтому люди в итоге вставляют в поисковик сырые обрывки вроде debug3: receive packet: type 51. Чтобы прочитать этот трейс, протокол знать наизусть не нужно. Нужно знать ту горстку строк, что отвечают на реальные вопросы, — и какие из строк просто шум.
Это руководство по чтению: что добавляет каждый уровень -v, какие фазы вы увидите по порядку и разбор строк, на которых стоит остановиться. (Сами по себе ошибки — refused, timed out, предупреждения о ключе хоста — и их исправления разобраны в разборе ошибок SSH.)
Что на самом деле добавляют -v, -vv и -vvv
-vпечатает строкиdebug1— рассказ на верхнем уровне. Какие конфиги прочитаны, куда идёт подключение, что предложил сервер, какие ключи перепробованы, какой метод аутентификации победил. Для большинства задач этого хватает.-vvдобавляетdebug2— детали переговоров: полные списки алгоритмов с обеих сторон, решения по каждому ключу.-vvvдобавляетdebug3— трейс на уровне пакетов, включая строкиsend packet: type N/receive packet: type N. Это тот уровень, где называются номера сообщений протокола, и именно отсюда берутся те загадочные строки, которые ищут в поиске.
Начинайте с -v. Берите -vvv, когда рассказ на -v обрывается внезапно и вам нужно увидеть тот самый пакет, на котором всё умерло.
Фазы — в том порядке, в котором вы их увидите
Каждое успешное подключение проходит один и тот же путь, и отладочный вывод следует за ним. Знание фаз позволяет понять, где произошёл сбой, ещё до того как вы разберётесь, что именно отказало.
1. Конфигурация. Первые строки — Reading configuration data /home/you/.ssh/config и .../etc/ssh/ssh_config, за ними Applying options for <pattern> для каждого совпавшего блока Host. Если 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 — это сервер перечисляет, что готов принять. Дальше клиент перебирает методы и ключи, по одной попытке за раз, пока что-нибудь не сработает — или пока не кончатся все варианты. На эту фазу приходится большая часть чтения, поэтому у неё отдельный разбор.
Трейс с пояснениями, от начала до конца
Вот настоящий (обрезанный) прогон -vvv для самого популярного в поиске сбоя — Permission denied (publickey) — со строками, которые важны, помеченными стрелкой. Все перечисленные выше фазы видны по порядку:
$ 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 # ← a Host block matched; suspect it if the user/key/port is wrong
debug1: Connecting to 203.0.113.10 [203.0.113.10] port 22.
debug1: Connection established. # ← TCP is up: refused / timed out is ruled out here
debug1: Local version string SSH-2.0-OpenSSH_9.6
debug1: Remote protocol version 2.0, remote software version OpenSSH_8.9p1 # ← you reached a real 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. # ← host-key phase passed; not a known_hosts problem
debug1: Authentications that can continue: publickey # ← keys only; no password will ever be offered
debug1: Offering public key: /home/you/.ssh/id_ed25519 ED25519 SHA256:def456... # ← the key the client actually tried
debug3: receive packet: type 51 # ← SSH_MSG_USERAUTH_FAILURE: the server rejected that key
debug1: Trying private key: /home/you/.ssh/id_rsa # ← agent keys exhausted; now falling back to key files
debug1: No more authentication methods to try.
deploy@203.0.113.10: Permission denied (publickey).
Читайте снизу вверх. Сбой — Permission denied (publickey); последняя настоящая попытка над ним — предложение id_ed25519, которое получило type 51. Значит, сервер увидел этот ключ и отказал — проблема на стороне сервера (не тот пользователь для входа, ключа нет в 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 или неправильно ведущий себя промежуточный узел: VPN и некоторые корпоративные файрволы фрагментируют или отбрасывают крупные пакеты. Проверьте из другой сети или без VPN; если подключается, настраивайте MTU, а не пяльтесь на ключи.
Unspecified GSS failure — шум от Kerberos. Клиент попробовал аутентификацию через GSSAPI, вы не в realm Kerberos, она не удалась, и он откатился к следующему методу. Если соединение в итоге успешно или падает на ключах, то эта строка тут ни при чём — игнорируйте её, если только вы действительно не пользуетесь SSO через Kerberos.
connect to address ... port 22: Connection refused / Connection timed out — соединение так и не состоялось, поэтому все вопросы об аутентификации неуместны. Refused означает, что хост ответил, но ничего не слушает; timed out — тишину на пути. Два разных расследования, и ни одно не связано с ключами — двухминутная диагностика разбирает обе ветки.
Рабочий процесс, который находит причину быстро
Три привычки превращают стену отладочного текста в двухминутное чтение:
- Воспроизведите без шума.
ssh -vvv -o IdentitiesOnly=yes -i ~/.ssh/the_key user@hostпредлагает ровно один ключ, так что в трейсе одна попытка вместо шести, и type 51 может значить только одно. - Читайте снизу вверх. Найдите сбой в конце, затем поднимайтесь к последнему решению перед ним — к финальному
Offering public key, к границе фазы, которую он так и не пересёк. Первые тридцать строк трейса почти всегда здоровы. - Проверьте, кто что задал. Когда поведение не совпадает с вашим замыслом, строки
Reading configuration dataиApplying options forвверху называют виновные файл и блок. Половина случаев «SSH игнорирует мои флаги» — это тихо побеждающий блок конфига.
Чтобы трейсов читать приходилось меньше
Трейс — правильный инструмент, когда что-то сломалось, но добрая часть того, что он раскрывает, — это состояние, которое не должно приходиться выяснять заново: какой ключ хочет этот хост, какой пользователь, какой порт. Termalin держит всё это вместе с сохранённым хостом, так что нужный ключ предлагается осознанно, а не четвёртым в очереди агента, и проверяет личность каждого сервера при первом подключении — с громким предупреждением, если отпечаток когда-нибудь изменится: фаза ключа хоста, обработанная намеренно. Живой статус хоста отвечает на вопрос «а сервер вообще доступен?» ещё до подключения — это ветка refused/timed-out из трейса, снятая целиком заранее. У тарифа Free нет ограничений на число хостов — скачайте приложение и приберегите -vvv для по-настоящему странных дней.
Termalin — бесплатный кроссплатформенный SSH-клиент, который хранит порты, пользователей, ключи и keepalive для каждого хоста вместе с ним и проверяет личность сервера при каждом подключении — скачайте его или посмотрите полный список возможностей.