WSL2에서 GitHub SSH 인증 문제 해결: Linux VM SSH 키 이전 가이드

핵심 기술

Windows의 WSL2 환경에서 GitHub 접속 시 발생하는 SSH 인증 오류를 해결하기 위해, Linux VM에 설정된 기존 SSH 키를 WSL2 환경으로 안전하게 이전하고 인증을 설정하는 방법을 안내합니다.

기술적 세부사항

• 문제 인식: Linux VM에서는 정상 작동하던 SSH 키가 WSL2에서는 GitHub 접근 시 Permission denied (publickey) 오류를 발생시키는 현상.
• 원인: WSL2는 자체적인 파일 시스템과 환경을 가지므로, Linux VM의 SSH 키를 자동으로 인식하지 못함.
• 해결 절차:
  1. Linux VM SSH 접속 확인: ssh -T git@github.com 명령으로 VM에서의 SSH 작동 상태를 검증.
  2. WSL2 .ssh 디렉터리 생성: mkdir -p ~/.ssh 명령으로 WSL2 내에 SSH 설정 파일 저장 디렉터리 생성.
  3. SSH 키 복사: scp 명령을 사용하여 Linux VM의 개인 키 (id_rsa) 및 공개 키 (id_rsa.pub)를 WSL2의 .ssh 디렉터리로 전송. (예: scp alok@<VM_IP>:/home/alok/.ssh/id_rsa ~/.ssh/id_rsa)
  4. 키 권한 설정: 복사된 개인 키 (id_rsa)에 chmod 600을, 공개 키 (id_rsa.pub)에 chmod 644를 설정하여 보안 강화.
  5. WSL2 SSH 인증 테스트: ssh -T git@github.com 명령으로 WSL2에서 GitHub 인증 성공 여부 확인.
  6. GitHub 저장소 클론: SSH 인증 성공 후 git clone 명령으로 저장소 접근 테스트.

개발 임팩트

• 다양한 개발 환경(Linux VM, WSL2) 간의 매끄러운 Git/GitHub 연동을 가능하게 합니다.
• SSH 키 관리 및 보안 설정을 통해 안전한 코드 접근 환경을 구축합니다.
• 개발 생산성 향상 및 환경 설정에 소요되는 시간 감소에 기여합니다.

커뮤니티 반응

• 언급된 오류 메시지 (The authenticity of host 'github.com' can't be established., Permission denied (publickey).)는 GitHub 및 Git 관련 커뮤니티에서 흔히 발생하는 문제로, 유사한 해결책이 공유되고 있습니다.