SSH: Permission denied (publickey)

안녕하세요, BlueByte입니다. "Permission denied (publickey)"는 벽처럼 느껴지지만, verbose로 물어보면 SSH가 이유를 정확히 알려줍니다 — 추측할 필요 없습니다. 오늘은 클라이언트가 실제로 무엇을 내밀었고 서버가 뭐라 했는지 읽고, 실패한 그 하나를 고치는 순서로 가보겠습니다.

이 메시지가 뜻하는 것

셸을 받기 전에 연결이 끊깁니다:

git@github.com: Permission denied (publickey).

서버가 공개키 인증을 제안했고, 클라이언트가 보낸 키 중 아무것도 받아들여지지 않았으며, 비밀번호 대체가 없었습니다. 셋 중 무엇이 실패했는지가 해결을 결정하니 — 추측하지 말고 SSH에 물어보세요.

보통 실패하는 세 가지

거의 모든 경우가 이 중 하나입니다:

• 키가 에이전트에 로드되지 않음, 또는 키 파일이 SSH가 찾는 위치에 없음.
• 클라이언트가 서버가 신뢰하는 것과 다른 키를 보냄 — 키가 여럿일 때 에이전트가 엉뚱한 걸 먼저 내미는 경우 흔함.
• 서버가 권한 때문에 거부 — ~/.ssh나 개인키 파일을 남이 읽을 수 있어 SSH가 무시함.

SSH에게 어느 쪽인지 묻기

verbose로 연결해 어떤 키를 내밀고 서버가 어떻게 답하는지 읽습니다:

ssh -vT git@github.com

Offering public key: ... 뒤 서버 응답을 보세요. 키를 안 내밀면 로드 안 된 것, 내밀었는데 거부되면 엉뚱한 키이거나 서버가 신뢰 안 하는 것, Permissions ... are too open 경고면 파일 모드 문제입니다. verbose 추적이 추측을 없앱니다.

실패한 그 하나를 고치기

1. 키를 안 내밀면 — 에이전트에 추가:

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

2. 엉뚱한 키를 내밀면 — 호스트별로 올바른 키를 지정:

# ~/.ssh/config
Host github.com
  IdentityFile ~/.ssh/id_ed25519
  IdentitiesOnly yes

3. 권한으로 거부되면 — 조입니다; SSH는 남이 읽을 수 있는 키를 무시합니다:

chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519

실제 사례: 에이전트가 옛 키를 내밀다

SSH로 clone하는데 Permission denied (publickey)가 납니다. ssh -vT git@github.com이 옛 키 id_rsa를 내밀고 서버가 거부하며, 더 새로운 id_ed25519엔 닿지도 못하는 걸 보여줍니다. 그러니 키 부재가 아니라 키 선택 문제입니다. Host github.com 블록에 IdentityFile ~/.ssh/id_ed25519와 IdentitiesOnly yes를 추가하고 ssh -vT를 다시 돌리니 이번엔 ed25519 키만 내밀고 서버가 "successfully authenticated"로 받아들입니다. clone이 됩니다.

키가 받아들여지는지 확인

셸을 열지 않고 인증 경로를 테스트:

ssh -T git@github.com

Hi <user>! You've successfully authenticated 같은 인사(그 뒤 연결을 닫더라도)가 나오면 키가 받아들여진 것입니다.

다시 겪지 않으려면

에이전트가 서버에 모든 키를 던져 시도 한도에 걸리지 않도록 SSH 설정에 IdentitiesOnly yes를 두고, 새 기기의 공개키를 서비스에 한 번 등록하고, ~/.ssh 권한을 조여 dotfiles 동기화가 이를 풀지 않게 하세요.

연결·호스트키 오류와의 구분

Permission denied (publickey)는 연결 후 인증 실패입니다. Connection refused나 Connection timed out은 더 이르게 — 서버 도달 불가나 22번 포트에 리스너 없음 — 이고, Host key verification failed는 서버 키가 바뀐 전혀 다른 문제입니다. publickey 오류를 만나면 ssh -vT부터 돌리세요 — 답은 거의 항상 그 추적에 있습니다.