SFTP 파일 전송 가이드

StreamGPU 인스턴스와 로컬 컴퓨터 간에 파일을 안전하게 전송하는 방법을 안내합니다. SFTP(SSH File Transfer Protocol)는 SSH를 기반으로 하여 보안이 강화된 전송 방식입니다.

1. SFTP 클라이언트 사용 (GUI)

터미널 명령어가 익숙하지 않다면 그래픽 기반의 SFTP 클라이언트를 사용하는 것이 편리합니다.

WinSCP (Windows 권장)

1. WinSCP 공식 사이트에서 설치합니다.
2. 새 세션 설정:
   • 전송 프로토콜: SFTP
   • 호스트 이름: 대시보드의 서버 주소
   • 포트 번호: 대시보드의 포트 번호
   • 사용자 이름: 대시보드나 접속 정보에 표시된 사용자명
3. 고급 설정 -> SSH -> 인증:
   • 개인키 파일: 다운로드한 .pem 파일을 선택합니다. (WinSCP가 .ppk로 변환을 제안하면 수락하세요.)

Cyberduck (Mac/Windows)

1. Cyberduck 공식 사이트에서 설치합니다.
2. 연결 열기를 클릭하고 SFTP를 선택합니다.
3. 서버 주소, 포트, 사용자명을 입력하고 SSH 개인키 항목에서 .pem 파일을 지정합니다.

2. 터미널을 이용한 전송 (CLI)

SFTP 기본 명령어

터미널에서 다음 명령어로 접속합니다:

sftp -i <보안키_경로> -P <포트_번호> <사용자명>@<서버_IP>

주요 SFTP 내부 명령:

• put <로컬_파일>: 로컬 파일을 서버로 업로드
• get <서버_파일>: 서버 파일을 로컬로 다운로드
• ls: 서버 파일 목록 확인
• cd <디렉터리>: 서버 디렉터리 이동
• exit: 연결 종료

SCP 명령어 (단일 파일 전송)

접속 유지 없이 바로 파일을 복사할 때 유용합니다.

# 로컬 파일을 서버로 복사
scp -i <보안키_경로> -P <포트_번호> <로컬_파일> <사용자명>@<서버_IP>:<서버_경로>

# 서버 파일을 로컬로 복사
scp -i <보안키_경로> -P <포트_번호> <사용자명>@<서버_IP>:<서버_파일> <로컬_경로>

3. 대용량 파일 전송 (rsync)

대용량 데이터나 많은 수의 파일을 전송할 때는 중단된 시점부터 재개가 가능한 rsync 사용을 권장합니다.

rsync -avz --progress -e "ssh -i <보안키_경로> -p <포트_번호>" <로컬_디렉터리>/ <사용자명>@<서버_IP>:<서버_경로>/

4. 주의사항

• 프로토콜 확인: StreamGPU는 보안을 위해 일반 FTP를 지원하지 않습니다. 반드시 SFTP를 선택하세요.
• 권한 오류: 파일을 업로드할 서버 경로에 쓰기 권한이 있는지 확인하세요. 일반적으로 본인 홈 디렉터리나 쓰기 권한이 있는 작업 디렉터리에서 작업하는 것이 안전합니다.
• 포트 번호: SSH 접속과 동일하게 인스턴스 전용 포트 번호를 사용해야 합니다. (-P 옵션은 대문자임에 유의)