🔐 우분투 서버에 SSH 공개키 등록해서 비밀번호 없이 접속하기

최근 학점가방(Unibag) 프로젝트를 진행하면서, 보안성과 편의성을 높이기 위해 SSH 접속 방식을 공개키 기반 인증으로 전환하게 되었다.

처음에는 낯설었지만, 설정해보니 구조가 명확했고 팀원들과의 커뮤니케이션도 자연스럽게 이어졌다.

이 글은 그 경험을 기록한 실전 가이드다.

✅ 서버 주소나 키 값은 보안을 위해 예시로 작성하였다.

---

📌 1. SSH 접속 시도 (초기 상태)

ssh odroid@<서버_IP>

사용한 이유: 서버에 기본적인 SSH 접속을 시도하기 위해 사용.

처음 접속 시 서버의 호스트 키가 로컬에 없기 때문에 경고 메시지가 뜬다.

The authenticity of host '<서버_IP>' can't be established.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

처음 접속이므로 yes를 입력하고 진행한다.

---

😢 비밀번호 인증 실패

odroid@<서버_IP>'s password:
Permission denied, please try again.

비밀번호를 모를 경우 접속이 불가능하다.

이 문제를 해결하기 위해 공개키 인증을 설정한다.

---

🪪 2. 로컬에서 SSH 키 생성

GitHub Actions용 (자동 배포를 위해)

ssh-keygen -t rsa -b 4096 -C "unibag-deploy@github-actions" -f ~/.ssh/unibag_github_actions

사용한 이유: GitHub Actions에서 비밀번호 없이 서버에 자동 접속할 수 있도록 키 쌍을 생성.

• f 옵션으로 키 파일 이름을 명시하고, C는 키 식별용 주석을 추가한다.

팀원용 (예: 팀원 키 발급)

ssh-keygen -t rsa -b 4096 -C "kim@unibag-team" -f ~/.ssh/team_kim

사용한 이유: 팀원이 키가 없다고 해서 대신 발급해드리기 위해 사용.

키 쌍을 발급한 뒤 공개키는 서버에 등록하고, 비공개키는 안전하게 전달한다.

---

✉️ 공개키 전달 및 등록 과정

액션 담당 팀원분이 서버에 접속이 필요하다고 하셔서, 대신 키를 만들어 등록을 도와드리기로 했다.

처음엔 “비공개키를 서버에 등록하고, 공개키로 로그인하는 건가요?”라고 물으셨는데,

정확한 방식은 다음과 같다:

1. 내 로컬에서 팀원용 키 생성bash ssh-keygen -t rsa -b 4096 -C "kim@unibag-team" -f ~/.ssh/team_kim
2. 공개키(team_kim.pub)를 서버의 odroid 계정에 등록bash mkdir -p ~/.ssh chmod 700 ~/.ssh cat ~/team_kim.pub >> ~/.ssh/authorized_keys chmod 600 ~/.ssh/authorized_keys
3. 비공개키(team_kim)를 zip 암호화해서 팀원에게 전달bash zip -e team_kim.zip ~/.ssh/team_kim
4. 팀원은 받은 키를 자신의 .ssh 폴더에 복사하고 권한 설정bash mv ~/Downloads/team_kim ~/.ssh/ chmod 600 ~/.ssh/team_kim
5. 접속 시bash ssh -i ~/.ssh/team_kim -p <포트번호> <계정명>@<서버_IP>

이런 흐름으로 비밀번호 없이 SSH 접속이 가능해졌다.

---

🔧 3. sshd 설정 확인 (필요시)

sudo nano /etc/ssh/sshd_config

사용한 이유: 서버가 공개키 인증을 허용하고 있는지 확인하고, 포트 등 설정을 점검하기 위함이다.

다음 항목들을 확인 또는 추가한다:

Port <포트번호>PubkeyAuthentication yesAuthorizedKeysFile .ssh/authorized_keys

설정을 변경한 경우에는 SSH 서버 재시작이 필요하다:

sudo systemctl restart ssh

단, 공개키를 등록한 경우에는 재시작을 할 필요가 없다.

---

✅ 4. SSH 공개키 인증 테스트

ssh -i ~/.ssh/team_kim -p <포트번호> <계정명>@<서버_IP>

사용한 이유: 공개키 기반으로 비밀번호 없이 접속이 잘 되는지 확인하기 위해 실행.

---

🧹 Host key verification 오류 해결

만약 다음과 같은 오류가 발생한다면:

Host key verification failed.

이는 이전에 저장된 서버의 호스트 키와 현재 키가 달라졌기 때문이다.

아래 명령어로 해결 가능하다:

ssh-keygen -R "[<서버_IP>]:<포트번호>"

사용한 이유: 기존에 저장된 잘못된 호스트키를 제거하기 위해 사용한다.

---

🔒 SSH 비밀번호 로그인 비활성화 방법 (공개키 인증만 허용)

공개키 기반 인증을 활성화한 후에는 기존 비밀번호 로그인 방식은 비활성화하는 것이 보안에 좋다.
이를 위해 SSH 설정 파일을 수정하고 SSH 서비스를 재시작한다.

📁 1. SSH 설정 파일 열기

sudo nano /etc/ssh/sshd_config

⚙️ 2. 아래 항목 수정

PasswordAuthentication no
ChallengeResponseAuthentication no
UsePAM no

🔹 이미 설정되어 있다면 주석(#)을 제거하고 no로 변경
🔹 PubkeyAuthentication yes가 켜져 있어야 공개키 인증이 정상 작동함

💾 3. 저장하고 종료

• Nano 기준: Ctrl + O → Enter → Ctrl + X

🔁 4. SSH 서비스 재시작

sudo systemctl restart ssh

✅ 완료

이제 비밀번호 방식은 차단되고, ~/.ssh/authorized_keys에 등록된 키로만 접속이 가능하다.

---

🧪 접속 테스트 팁

SSH 세션이 끊기면 다시 붙기 어려울 수 있으니, 설정 전 기존 세션은 그대로 둔 채 새 터미널에서 테스트 접속을 권장한다.

ssh -i ~/.ssh/mykey <계정명>@<서버_IP> -p <포트번호>

✅ 결론

• 공개키 인증은 SSH 접속을 훨씬 편하게 만든다.
• 자동화에는 암호 없는 키, 개인용은 암호 있는 키 사용을 추천한다.
• 공개키와 비공개키의 역할을 정확히 이해하는 것이 중요하다.
• 실무에서 키를 분리하여 관리하는 습관은 보안상 매우 좋다.