[Git] SSH 전환 방법(GitHub 502 오류)

2025. 1. 14. 12:13코딩 도구/프로젝트 개발 및 문제, 오류 해결

반응형

GitHub SSH 전환 방법

GitHub에 코드를 푸시하는 과정에서 HTTPS 대신 SSH를 사용하는 방법을 알아보겠습니다. SSH는 보안성과 편리함을 동시에 제공하며, 비밀번호 입력 없이도 안전하게 원격 저장소와 연결할 수 있습니다.


SSH란?

SSH(Secure Shell)는 안전한 네트워크 통신을 제공하는 프로토콜입니다. GitHub에 코드를 푸시할 때, SSH 키를 사용하여 인증할 수 있습니다.


SSH 설정 방법

1. SSH 키 생성

ssh-keygen -t ed25519 -C "your-email@example.com"
  • -t ed25519: 보안성이 높은 최신 키 타입 사용
  • -C: GitHub에 등록할 이메일

생성된 키 파일 위치:

  • 공개 키: ~/.ssh/id_ed25519.pub
  • 개인 키: ~/.ssh/id_ed25519

2. SSH 에이전트 실행 및 키 추가

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


3. GitHub에 SSH 키 등록

  1. cat ~/.ssh/id_ed25519.pub 명령어를 실행하고 공개 키를 복사합니다.
  2. GitHub > Settings > SSH and GPG keys로 이동
  3. New SSH Key 클릭 후 공개 키를 붙여넣고 저장합니다. (마지막 이메일까지!!)


4. SSH URL로 원격 저장소 전환

기존의 HTTPS URL을 SSH로 변경합니다:

git remote set-url origin git@github.com:mk-isos/JavaStudy.git

변경 사항을 확인하려면:

git remote -v

 


5. SSH 연결 테스트

ssh -T git@github.com

정상적으로 연결되었다면, 다음과 같은 메시지가 나타납니다:

Hi <username>! You've successfully authenticated, but GitHub does not provide shell access.


6. SSH를 사용한 푸시

git push origin main

결론

  • SSH는 GitHub과의 연결을 보안성 높게 유지할 수 있는 방법입니다.
  • 한 번 설정하면 비밀번호 입력 없이 지속적으로 사용할 수 있습니다.
반응형