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. 설정. 첫 줄들은 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는 서버가 받아들일 방식을 나열한 것입니다. 그다음 클라이언트는 방식과 키를 한 번에 하나씩 훑어 나가며, 무언가 성공하거나 — 아무것도 성공하지 못할 때까지 계속합니다. 이 단계에서 읽을 거리가 가장 많으므로, 전용 해독기를 따로 둡니다.
처음부터 끝까지, 주석 달린 트레이스
가장 많이 검색되는 실패 — 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 문제나 말썽을 부리는 미들박스입니다 — 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분짜리 읽을거리로 바꿔 줍니다:
- 잡음을 걷어 내고 재현하기.
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 클라이언트입니다 — 다운로드하거나 전체 기능 목록을 둘러보세요.