기타

GitHub 저장소를 새로운 노트북에서 SSH로 Clone 받기

D.Y 2025. 4. 26. 22:08
반응형

개요

새로운 노트북을 사용할 때, GitHub 저장소를 안전하게 복제(Clone)하기 위해서는 SSH 키를 사용하여 인증 과정을 설정해야 합니다.
이 문서에서는 SSH 키를 생성하고 GitHub에 등록하여 저장소를 SSH 방식으로 clone 받을 때까지의 과정을 단계별로 설명하고, 각 과정의 이유도 함께 설명합니다.

왜 SSH 키를 사용해야 할까?

GitHub은 보안을 위해 저장소에 접근할 때 인증을 요구합니다.
기본적으로 두 가지 방식이 있습니다.

  • HTTPS 방식: 매번 사용자 이름과 비밀번호(또는 Personal Access Token)를 입력해야 함
  • SSH 방식: 한번 키를 설정해두면 비밀번호 입력 없이 안전하게 통신 가능

SSH 키를 사용하면,

  • 비밀번호 없이 편하게 작업할 수 있고
  • 키 기반 인증은 훨씬 안전합니다.

SSH 키를 생성하고 등록하는 이유

과정 이유 비유
SSH 키 생성 비밀번호 대신 사용할 개인 열쇠(Private Key) 를 만드는 것 열쇠를 직접 제작
SSH 에이전트에 등록 매번 파일에서 열쇠를 꺼내지 않고, 메모리에 열쇠를 보관하는 것 열쇠를 가방에 넣어두는 것
GitHub에 공개키 등록 GitHub에게 이 열쇠를 가진 사람만 통과시켜달라고 알려주는 것 GitHub에 열쇠 복사본을 맡기는 것

 

정리

  • 내 노트북은 Private Key를 가진다.
  • GitHub은 Public Key를 등록해 놓는다.
  • 둘이 짝이 맞으면 인증이 완료되어 작업할 수 있다.

GitHub 저장소를 SSH로 Clone 받기까지의 단계

1. Git 설치 확인

먼저 Git이 설치되어 있는지 확인합니다.

$ git --version

없다면 Git 공식 홈페이지에서 설치합니다.
👉 Git 다운로드

2. SSH 키 존재 여부 확인

로컬 컴퓨터에 이미 SSH 키가 있는지 확인합니다.

$ ls -al ~/.ssh
  • id_rsa, id_ed25519 파일이 없다면 → 3번으로 진행합니다.

3. SSH 키 생성

SSH 키가 없다면 새로 생성합니다.

$ ssh-keygen -t ed25519 -C "your_email@example.com"
  • 파일 저장 경로는 기본값(Enter)
  • 패스프레이즈도 필요 없으면 Enter

생성 결과:

  • ~/.ssh/id_ed25519 (Private Key)
  • ~/.ssh/id_ed25519.pub (Public Key)

4. SSH 에이전트 시작 및 키 등록

SSH 에이전트는 열쇠를 메모리에 저장해주는 역할을 합니다.

# ssh-agent 실행 
$ eval "$(ssh-agent -s)" 

# 생성한 키 등록 
$ ssh-add ~/.ssh/id_ed25519

등록된 키를 확인합니다.

$ ssh-add -l

5. GitHub에 SSH 공개 키 등록

GitHub에 등록해야 GitHub이 내 키를 신뢰할 수 있습니다.

 

1. Public Key 복사

$ cat ~/.ssh/id_ed25519.pub

 

2. GitHub 접속

  1. GitHub → Settings → SSH and GPG keys → New SSH key
  2. Title: 노트북 이름 등 작성
  3. Key: 복사한 내용을 붙여넣기

6. GitHub 연결 테스트

제대로 등록되었는지 확인합니다.

$ ssh -T git@github.com

7. GitHub 저장소를 SSH로 Clone

이제 SSH 주소를 사용해 저장소를 clone 할 수 있습니다.

$ git clone git@github.com:USERNAME/REPOSITORY.git
 

예시:

$ git clone git@github.com:username/server.git

최종 요약

새로운 노트북에서는
(1) SSH 키를 만들고,
(2) SSH 에이전트에 등록하고,
(3) GitHub에 Public Key를 등록한 후,
(4) SSH 방식으로 안전하게 clone 하면 된다.

반응형