Ubuntu 서버에서 Git SSH 키 등록 방법

1. SSH 키 생성하기

먼저 SSH 키 페어를 생성합니다. 터미널에서 다음 명령어를 실행합니다:

ssh-keygen -t ed25519 -C "your_email@example.com"

참고: 구형 시스템의 경우 아래 명령어를 사용하세요:

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

명령어 실행 시:

• 키 저장 위치를 물어보면 기본값(~/.ssh/id_ed25519)으로 설정
• 비밀문구(passphrase)는 선택적으로 설정 가능

2. SSH 에이전트 시작 및 키 추가

SSH 에이전트를 백그라운드에서 시작:

eval "$(ssh-agent -s)"

생성한 SSH 키를 에이전트에 추가:

ssh-add ~/.ssh/id_ed25519

3. 공개키 복사

공개키를 표시하고 복사:

cat ~/.ssh/id_ed25519.pub

출력된 내용을 복사합니다.

4. GitHub에 SSH 키 등록

1. GitHub 웹사이트에 로그인
2. 우측 상단의 프로필 아이콘 클릭 → Settings 선택
3. 좌측 사이드바에서 "SSH and GPG keys" 선택
4. "New SSH key" 또는 "Add SSH key" 버튼 클릭
5. Title에 식별 가능한 이름 입력 (예: "Work Ubuntu Server")
6. Key 필드에 복사한 공개키 붙여넣기
7. "Add SSH key" 버튼 클릭하여 저장

5. 연결 테스트

SSH 연결이 정상적으로 작동하는지 테스트:

ssh -T git@github.com

정상적으로 연결되면 다음과 같은 메시지가 표시됩니다:

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

주의사항

• SSH 키는 서버마다 별도로 생성하는 것이 보안상 좋습니다.
• 비밀문구 설정은 선택사항이지만, 보안을 위해 설정하는 것을 권장합니다.
• 개인키(id_ed25519)는 절대로 공유하지 마세요.
• 공개키(id_ed25519.pub)만 GitHub에 등록합니다.

문제해결

SSH 연결이 안 되는 경우 다음을 확인하세요:

# SSH 연결 디버깅
ssh -vT git@github.com

# SSH 설정 확인
ls -la ~/.ssh/

# SSH 에이전트에 등록된 키 확인
ssh-add -l

이제 SSH를 통해 GitHub 저장소를 클론하거나 푸시할 수 있습니다.