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

개요

새로운 노트북을 사용할 때, 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 하면 된다.