원격 접속 가이드

이 문서는 StreamGPU에서 생성한 서버에 접속하는 방법을 단계별로 설명합니다. 기술 지식이 많지 않아도 쉽게 따라하실 수 있도록 구성했습니다.

1단계: 보안키 다운로드

서버를 생성하면 화면에 팝업창이 나타납니다. 이 창에서 "보안키 다운로드" 버튼을 클릭하세요.

다운로드되는 파일 이름 예시: my-server-abc123.pem

2단계: 보안키 파일 이동 및 권한 설정

다운로드한 보안키 파일을 안전한 위치로 옮기고, 본인만 읽을 수 있도록 권한을 설정합니다.

Mac 또는 Linux 사용자

터미널(Terminal)을 열고 아래 명령어를 순서대로 실행하세요:

mkdir -p ~/.ssh/streamgpu
mv ~/Downloads/<다운로드한파일명> ~/.ssh/streamgpu/<다운로드한파일명>
chmod 600 ~/.ssh/streamgpu/<다운로드한파일명>

위 명령어는 보안키 파일을 안전한 폴더로 옮기고, 본인만 읽을 수 있도록 설정합니다.

Windows 사용자

Windows에서는 여러 방법으로 SSH를 사용할 수 있습니다. 본인 환경에 맞는 방법을 선택하세요.

방법 1: PowerShell / CMD (OpenSSH)

Windows 10/11에는 OpenSSH가 기본 포함된 경우가 많습니다. PowerShell을 열고 아래 명령어를 실행하세요:

# 폴더 생성 및 파일 이동
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.ssh\streamgpu"
Move-Item -Path "$env:USERPROFILE\Downloads\<다운로드한파일명>" -Destination "$env:USERPROFILE\.ssh\streamgpu\<다운로드한파일명>"

# 권한 설정 (본인만 읽기 가능하도록)
icacls "$env:USERPROFILE\.ssh\streamgpu\<다운로드한파일명>" /inheritance:r /grant:r "$env:USERNAME:(R)"

참고: Windows에서는 리눅스의 chmod 600 대신 icacls로 권한을 설정합니다.

방법 2: Git Bash / WSL (권장: 리눅스와 동일한 환경)

Git Bash나 WSL을 설치하면 리눅스와 동일한 명령어를 사용할 수 있습니다:

mkdir -p ~/.ssh/streamgpu
mv ~/Downloads/<다운로드한파일명> ~/.ssh/streamgpu/
chmod 600 ~/.ssh/streamgpu/<다운로드한파일명>

방법 3: PuTTY 사용 시

PuTTY는 .ppk 형식의 키를 사용합니다. 대시보드에서 받은 .pem 파일을 변환해야 합니다:

1. PuTTYgen 실행 → Load로 .pem 파일 불러오기 (파일 형식을 'All Files'로 선택)
2. Save private key로 .ppk 파일 저장
3. PuTTY에서 Connection → SSH → Auth → "Private key file"에 .ppk 지정

3단계: 서버 접속

대시보드 화면에 표시된 접속 명령을 복사하세요. 명령은 아래와 비슷한 형태입니다:

ssh -i ~/.ssh/streamgpu/<파일명> awesome@<서버주소> -p <포트번호>

문제가 발생했나요?

• 보안키를 다운로드하지 못했어요
  보안키는 서버 생성 시 단 한 번만 제공되며, 보안상의 이유로 StreamGPU 서비스에서도 저장하지 않습니다. 다운로드를 놓쳤다면 해당 서버는 접속할 수 없으므로 서버를 삭제하고 새로 생성해야 합니다.
• "권한이 거부되었습니다" 오류가 나요
  2단계의 권한 설정을 다시 확인해보세요. 보안키 파일은 본인만 읽을 수 있어야 합니다.
• 연결이 안 돼요
  서버 주소와 포트번호가 정확한지 확인하세요. 회사나 공공 와이파이를 사용 중이라면 네트워크 관리자에게 문의가 필요할 수 있습니다.
• 처음 접속할 때 경고가 나와요
  처음 서버에 접속하면 호스트 키 확인 메시지가 나타납니다. 이 메시지에는 서버의 "지문(fingerprint)"이 표시됩니다.
  🔐 보안 팁
  가능하다면 대시보드나 관리자에게서 제공받은 지문과 일치하는지 확인하세요. 일치하지 않으면 연결을 중단하고 관리자에게 문의해야 합니다(중간자 공격 가능성). 확인이 어렵다면 yes를 입력하고 진행할 수 있지만, 주의가 필요합니다.
• Too many authentication failures
  SSH가 여러 키를 시도하며 실패할 수 있습니다. 다음 옵션을 추가해보세요:

  ssh -o IdentitiesOnly=yes -i ~/.ssh/streamgpu/<파일명> awesome@<서버주소> -p <포트번호>

보안 안내

• 보안키 파일은 절대 다른 사람과 공유하지 마세요
• 외부 감염 등에 대비해 주기적으로 접속 기록을 확인하세요