SFTP로 파일 전송하기
WinSCP, FileZilla, 내장 sftp 클라이언트, macOS Finder로 서버에서 파일을 업로드하고 다운로드하는 방법을, SFTP를 일반 FTP와 혼동하지 않고 설명해요.
업데이트 2026년 8월 23일
SFTP는 같은 SSH 연결을 통한 파일 전송이에요. 별도의 서버를 설정할 필요가 없어요. ssh가 작동한다면 SFTP도 작동해요.
그래픽 클라이언트에서 연결하기
WinSCP, FileZilla, Cyberduck 모두 설정이 동일해요:
| 항목 | 값 |
|---|---|
| 프로토콜 | SFTP (FTP도 FTPS도 아니에요) |
| 호스트 | “개요” 탭에 있는 머신 주소 |
| 포트 | 22 |
| 사용자 | root 또는 본인 사용자 |
| 비밀번호 | “접근” 탭에 있는 root 비밀번호 |
| 키 | 비밀번호 로그인이 비활성화된 경우 개인 키 경로 |
WinSCP는 .ppk 형식의 키만 허용해요. 변환 방법은 PuTTY 문서에 설명되어 있어요. FileZilla는 일반 OpenSSH 키도 읽어요.
포트 21과 “일반 FTP”는 머신에서 작동하지 않고 설정할 필요도 없어요. FTP는 비밀번호를 평문으로 전송해요. 항상 SFTP를 선택하세요.
명령줄 클라이언트
Windows, macOS, Linux에 기본 내장되어 있어요:
sftp root@203.0.113.10
내부에서 간단한 명령을 사용할 수 있어요:
ls
cd /var/www
lcd C:\work
put index.html
put -r ./site
get /var/log/nginx/error.log
bye
put은 머신으로 보내고, get은 내 컴퓨터로 파일을 가져와요. l로 시작하는 명령(lcd, lls)은 내 컴퓨터에서 작동해요.
~/.ssh/config 파일을 설정했다면 sftp vds만으로 충분해요.
macOS와 Linux의 파일 관리자
Finder에서는 이동 → 서버에 연결 → sftp://root@203.0.113.10을 입력해요. GNOME 파일에서는 “다른 위치” 필드에 주소를 입력하세요. 머신의 디렉터리가 네트워크 폴더로 열려요.
지속적인 작업에는 디렉터리를 로컬처럼 마운트하는 것이 더 편리해요:
sshfs root@203.0.113.10:/var/www /mnt/vds
파일을 어디에 둘까요
| 무엇 | 어디 |
|---|---|
| 웹사이트 | /var/www/<domain> |
| 애플리케이션 또는 봇 | /opt/<name> |
| 개인 파일 | 사용자의 홈 디렉터리 |
| 임시 | /tmp (재부팅 시 삭제됨) |
업로드 후에는 소유자를 설정해야 하는 경우가 많아요. 그렇지 않으면 웹 서버가 403을 받아요:
chown -R www-data:www-data /var/www/example.com
chmod -R 755 /var/www/example.com
자주 발생하는 오류
| 증상 | 원인 |
|---|---|
쓰기 시 Permission denied | 디렉터리가 다른 사용자 소유이고 root로 로그인하지 않았어요 |
| SSH는 작동하는데 클라이언트가 연결되지 않음 | 설정에서 SFTP 대신 FTP를 선택했거나 포트가 21이에요 |
| 업로드는 성공했지만 사이트가 파일을 인식하지 못함 | 잘못된 디렉터리이거나 소유자가 설정되지 않았어요 |
| 대용량 파일에서 연결 끊김 | 클라이언트에서 keepalive를 활성화하세요. 대용량 업로드에는 rsync를 사용하세요 — 이어받기가 가능해요 |
| 러시아어 파일 이름이 깨짐 | 클라이언트 설정에서 UTF-8 인코딩을 설정하세요 |
SFTP가 최선이 아닌 경우
수백 개의 작은 파일과 반복적인 배포에는 rsync가 더 빨라요. 변경된 부분만 전송하기 때문이에요. 단일 파일에는 scp가 더 간단해요. 두 명령 모두 scp와 rsync 문서에서 다뤄요.