Skip to content

KSA 서버 접속하는 방법

UWKSA 서버에 안전하게 접속하기 위해 SSH 키를 사용합니다. 아래 단계를 따라 진행해주세요.

본 문서는 Github의 이 문서를 참조하여 작성되었습니다.

1단계: SSH 키 생성하기

SSH 키 쌍(Private Key와 Public Key)을 생성합니다.

Windows/Linux/Mac

# 터미널/콘솔에서 실행
ssh-keygen -t ed25519 -C "[email protected]"
  • [email protected] 부분은 임의의 문자열을 사용해도 됩니다. 본인이 식별할 수 있는 값을 권장합니다.

생성된 키는 다음 위치에 저장됩니다:

  • Private Key: ~/.ssh/id_ed25519 (테크 리드가 달라고 해도 공유하지 마세요)
  • Public Key: ~/.ssh/id_ed25519.pub (서버에 등록할 키) => 이걸 공유해야 합니다.

2단계: Public Key 확인하기

생성한 Public Key를 확인합니다.

윈도우 기준 (PowerShell)

# Public Key 내용 확인
type $env:USERPROFILE\.ssh\id_ed25519.pub

Linux/MacOs ( Bash/Zsh)

# Public Key 내용 확인
cat ~/.ssh/id_ed25519.pub

내용을 확인 후, 복사해주세요. ( 파일 전체를 복사하여도 무방합니다)

3단계: Public Key 등록하기

서버 관리자에게 전달

복사한 Public Key를 서버 관리자에게 전달하여 서버에 등록을 요청합니다. ( Tech Lead 또는 권한자 )

GitHub에 등록

자신의 GitHub 계정에도 Public Key를 등록해주세요!

  1. GitHub SSH Keys 설정 페이지로 이동
  2. New SSH key 버튼 클릭
  3. Title에 키를 구분할 수 있는 이름을 입력합니다 (예: UWKSA_SERVER_KEY)
  4. Key 필드에 복사한 Public Key 붙여넣기
  5. Add SSH key 버튼 클릭

4단계: 서버 접속하기

서버 관리자가 Public Key를 등록하면, SSH를 사용하여 서버에 접속할 수 있습니다.

Windows/Linux/Mac 공통

# 기본 접속 (포트 22)
ssh ubuntu@server_address

서버 주소는 관리자에게 문의해주세요.

트러블슈팅

시작하기 전에

  • 컴퓨터 재시작하기
  • 와이파이 껐다 켜기
  • VPN 끄기
  • 로그아웃 후 로그인해보기
  • 랜선 뽑았다 꽂아보기

를 실시한 후에도 문제가 해결되지 않았다면, 아래 방법들도 시도해보세요

Permission denied (publickey)

  • Public Key가 서버에 제대로 등록되었는지 확인
  • 제대로 된 private key를 사용하고 있는지 확인
  • 이미 다른 서버 때문에 기존에도 (oracle 등등) private key를 사용하고 있다면, -i 옵션으로 명시적으로 키 파일을 지정해보세요.
  • Private Key 파일의 권한 확인

Linux/Mac에서 권한 설정:

chmod 600 ~/.ssh/id_ed25519
chmod 644 ~/.ssh/id_ed25519.pub

Windows에서 권한 설정:

# 현재 사용자만 읽을 수 있도록 설정
icacls $env:USERPROFILE\.ssh\id_ed25519 /inheritance:r
icacls $env:USERPROFILE\.ssh\id_ed25519 /grant:r "$($env:USERNAME):(R)"

Connection timeout 오류

  • 네트워크 연결 확인
  • 방화벽 설정 확인
  • 서버 주소와 포트 번호가 올바른지 확인
  • ~~와이파이 껐다 켜세요~~

Host key verification failed 오류

  • 서버의 호스트 키가 변경되었을 때 발생합니다.
  • ~/.ssh/known_hosts 파일에서 해당 서버의 이전 키를 삭제한 후에 다시 시도하세요.
ssh-keygen -R server_address

서버 주소는 관리자에게 문의해주세요.

추가 팁

SSH Config 파일 사용하기

매번 긴 명령어를 입력하지 않고, SSH 설정 파일을 만들어 간편하게 접속할 수 있습니다.

Windows/Linux/Mac 공통

~/.ssh/config 파일을 생성하고 다음 내용을 추가:

Host ksa-server
    HostName server_address
    User username
    Port PORT_NUMBER
    IdentityFile ~/.ssh/id_ed25519

설정 후 간단하게 접속:

ssh ksa-server

이제 KSA 서버에 안전하게 접속할 수 있습니다. 추가 질문이 있으면 서버 관리자에게 문의하세요.