개발 오류 해결

git push Permission denied (publickey) 해결: SSH 키·HTTPS

치현AI 2026. 11. 20. 19:10

git push에서 git@github.com: Permission denied (publickey).가 나오면, 깃허브가 내 컴퓨터의 SSH 키를 모른다는 뜻입니다. 키를 만들고 → 공개키(.pub)를 깃허브에 등록하고 → ssh -T로 확인하면 해결됩니다.

ssh-keygen -t ed25519 -C "내메일@example.com"
cat ~/.ssh/id_ed25519.pub      # 이 한 줄을 깃허브 Settings → SSH and GPG keys에 붙여넣기
ssh -T git@github.com

SSH가 번거로우면 HTTPS로 바꿔도 됩니다(5번). 윈도우는 Git Bash에서 같은 명령을 씁니다. 우분투 24.04에서 직접 실행해 확인했습니다.

1. 오류가 나는 이유: 키가 없거나, 등록이 안 됐거나

SSH 주소(git@github.com:아이디/저장소.git)로 push하면 git은 SSH 키로 로그인합니다. 받아 줄 키가 없으면 이 메시지가 나옵니다. 테스트 서버에 키를 등록하기 전 접속 결과입니다. (테스트 서버라 주소가 다릅니다. 깃허브에서는 git@github.com으로 나옵니다)

gitlab_test@127.0.0.1: Permission denied (publickey).

-v를 붙이면 어떤 키를 내밀었다가 거절당했는지 보입니다.

debug1: Offering public key: other ED25519 SHA256:BKM6...66SY explicit
debug1: Authentications that can continue: publickey
debug1: No more authentication methods to try.

흔한 원인은 ① 키가 없음 ② 공개키를 깃허브에 안 붙임 ③ 키 파일 권한이 열려 있어 무시됨, 세 가지입니다.

2. ed25519 키 만들기

먼저 ls ~/.ssh로 id_ed25519, id_ed25519.pub가 이미 있는지 봅니다. 없으면 만듭니다. passphrase는 넣는 것을 권합니다(시험에서는 비움).

ssh-keygen -t ed25519 -C "you@example.com"
# Your identification has been saved in .../id_ed25519
# Your public key has been saved in .../id_ed25519.pub
# The key fingerprint is:
# SHA256:Ja5lMZVv...mjNChY you@example.com

만들어진 권한은 개인키 600, 공개키 644였습니다. 깃허브에 올리는 것은 .pub 공개키뿐이고, 개인키는 누구에게도 보내지 않습니다.

권한이 열려 있으면 키가 무시됩니다

개인키를 일부러 644로 바꾸고 접속하자 결국 같은 오류가 떴습니다. (테스트 서버라 주소가 다릅니다. 깃허브에서는 git@github.com으로 나옵니다)

(일부 줄 생략)

Permissions 0644 for 'id_ed25519' are too open.
This private key will be ignored.
Load key "id_ed25519": bad permissions
gitlab_test@127.0.0.1: Permission denied (publickey).

chmod 600 ~/.ssh/id_ed25519로 되돌립니다.

3. ssh-agent에 키 올리기

passphrase를 매번 치지 않도록 agent에 올립니다.

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
# Identity added: ... (you@example.com)
ssh-add -l
# 256 SHA256:Ja5lMZVv...mjNChY you@example.com (ED25519)

agent를 켜지 않고 ssh-add만 하면 Could not open a connection to your authentication agent.가 나옵니다. 직접 확인한 메시지입니다.

키 이름을 바꿨거나 여러 개면 ~/.ssh/config에 지정합니다(ssh -G github.com으로 읽히는 것 확인).

Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519
  IdentitiesOnly yes

4. 깃허브에 공개키 등록하고 ssh -T로 확인

  • cat ~/.ssh/id_ed25519.pub 출력 한 줄(ssh-ed25519 AAAA... 메일)을 그대로 복사합니다.
  • 깃허브 오른쪽 위 프로필 → Settings → SSH and GPG keys → New SSH key에 붙여넣고 저장합니다.
  • ssh -T git@github.com을 실행합니다.

깃허브 공식 문서에 따르면 성공하면 Hi 아이디! You've successfully authenticated, but GitHub does not provide shell access.가 나옵니다. "shell access를 안 준다"는 말은 정상입니다. 이 환경에서는 ssh: connect to host github.com port 22: Connection refused로 접속 자체가 안 돼 이 메시지를 직접 받지는 못했습니다.

대신 테스트 서버에 같은 공개키를 등록하자 바로 로그인됐습니다. "등록 전 거절 → 등록 후 통과" 흐름은 같습니다. (테스트 서버라 주소가 다릅니다. 깃허브에서는 github.com으로 나옵니다)

debug1: Server accepts key: id_ed25519 ED25519 SHA256:Ja5lMZVv...mjNChY explicit
Authenticated to 127.0.0.1 ([127.0.0.1]:2222) using "publickey".

22번 포트가 막힌 회사망이라면 깃허브 문서대로 443 포트용 주소 ssh.github.com을 쓰는 방법이 있습니다(ssh -T -p 443 git@ssh.github.com). 이 환경에서는 이 주소도 접속되지 않아 확인하지 못했습니다.

5. SSH 대신 HTTPS로 바꾸기

원격 주소만 바꾸면 SSH 키가 필요 없습니다.

git remote -v
git remote set-url origin https://github.com/아이디/저장소.git
git config --get remote.origin.url
# https://github.com/USER/REPO.git

HTTPS push에서 깃허브는 계정 비밀번호를 받지 않습니다. 비밀번호 칸에 개인 액세스 토큰(PAT)을 넣거나, 윈도우용 Git의 Git Credential Manager로 브라우저 로그인을 합니다.

6. 한 줄 요약

증상 원인 해결
Permission denied (publickey) 키 없음 / 깃허브 미등록 ssh-keygen 후 .pub 등록
bad permissions, key will be ignored 개인키 권한 644 등 chmod 600
Could not open a connection to your authentication agent agent 미실행 eval "$(ssh-agent -s)"
port 22: Connection refused / timed out 22번 포트 차단 ssh.github.com 443 또는 HTTPS

실행 환경: 2026년 11월 18일, 우분투 24.04, OpenSSH 9.6p1, git 2.43.0. 키 생성·agent·권한 오류·config는 직접 실행했습니다. 이 환경에서는 깃허브 접속이 막혀 있어 깃허브 접속 결과(성공 메시지)는 공식 문서 기준이고, 같은 Permission denied 오류는 테스트용 SSH 서버를 띄워 재현했습니다. 초안 작성과 검수에 AI를 사용했습니다.

기준일: 2026-11-18

출처