AI Store에서 AI코딩으로 만들어진 앱을 만나보세요!
지금 바로 방문하기

Git + GitHub con SSH: 단계별 가이드

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

DevOps

대상자

  • 초보 개발자에게 SSH 설정 방법을 쉽게 설명
  • 중간 수준 개발자에게 보안 강화 및 자동화 기능 제공
  • 프로페셔널 개발 환경에서의 실무 적용 가능성 강조

핵심 요약

  • SSH 키 생성ssh-keygen -t ed25519 -C "이메일" 명령어로 수행 (코드 형식 강조)
  • SSH 에이전트에 키 추가ssh-add ~/.ssh/id_ed25519 명령어 사용 (코드 형식 강조)
  • GitHub에 키 업로드git clone git@github.com:유저/리포.git (SSH URL 사용)

섹션별 세부 요약

1. SSH 키 존재 확인

- ls ~/.ssh 명령어로 id_ed25519.pub 파일 존재 여부 확인

- 파일이 없으면 다음 단계에서 생성

2. SSH 키 생성

- ssh-keygen -t ed25519 -C "이메일" 명령어 실행

- 기본 파일명 id_ed25519 사용 또는 커스텀 이름 지정

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

- eval "$(ssh-agent -s)" 명령어로 에이전트 시작

- ssh-add ~/.ssh/id_ed25519 명령어로 키 추가 (파일명 맞춤)

4. GitHub에 키 업로드

- cat ~/.ssh/id_ed25519.pub 명령어로 공개 키 복사

- GitHub > Settings > SSH and GPG keys > New SSH key 메뉴에서 키 등록

5. SSH 설정 파일 구성 (선택 사항)

- code ~/.ssh/config 명령어로 파일 편집

- 복수 키 사용 시 Host github 섹션에 IdentityFile 경로 및 IdentitiesOnly yes 설정

6. 오류 해결: "Permission denied (publickey)"

- ssh -vT git@github.com 명령어로 디버깅 로그 확인

- 정확한 키 사용 여부 확인 후 ssh -T github 명령어로 테스트

7. SSH URL 사용

- HTTPS 대신 git clone git@github.com:유저/리포.git 형식의 SSH URL 사용

- 기존 HTTPS URL은 git remote set-url origin git@github.com:유저/리포.git로 변경

결론

  • SSH 설정 시 git@github.com 형식의 URL 사용이 필수이며, 에이전트 설정과 키 파일 경로 확인으로 오류 예방이 가능하다.
  • 복수 키 사용 시 ~/.ssh/config 파일 구성이 권장되며, 정기적인 키 검증으로 보안 강화가 필요하다.