파일 전송 가이드
로컬 PC와 서버 사이에 파일을 주고받는 가장 안전한 방법은 SSH 기반 전송 프로토콜입니다.
FTP는 평문 전송으로 보안에 취약하니 SFTP/SCP를 사용하세요.
프로토콜 한눈에 비교
| 프로토콜 | 포트 | 암호화 | 용도 |
|---|---|---|---|
| SFTP | 22 | ✅ SSH | 파일 탐색기 형태로 업/다운로드 |
| SCP | 22 | ✅ SSH | 단일 파일·폴더 빠른 복사 (CLI) |
| FTP | 21 | ❌ 평문 | 사용 비권장 |
CLI — SCP / SFTP (Mac/Linux/Windows PowerShell)
📤 로컬 → 서버 업로드 (SCP)
단일 파일 업로드
$scp ./index.html [email protected]:/var/www/html/폴더 전체 업로드 (-r)
$scp -r ./mysite [email protected]:/var/www/📥 서버 → 로컬 다운로드 (SCP)
서버 파일 가져오기
$scp [email protected]:/var/log/nginx/access.log ./🗂️ SFTP 대화형 모드
대화형 셸로 진입해 파일 탐색기처럼 사용할 수 있습니다.
SFTP 접속
$sftp [email protected]put 파일 — 업로드get 파일 — 다운로드ls / cd / pwd — 서버 탐색lls / lcd / lpwd — 로컬 탐색mkdir / rm — 폴더 생성/삭제bye / exit — 종료Windows 사용자 — WinSCP
WinSCP는 Windows에서 가장 널리 쓰이는 무료 SFTP/SCP 클라이언트입니다. 탐색기처럼 좌(로컬) / 우(서버) 패널 사이를 드래그앤드롭으로 전송할 수 있습니다.
🚀 접속 절차
- winscp.net에서 다운로드 후 설치
- 실행 후 새 사이트 선택, 다음 정보 입력:
- 파일 프로토콜: SFTP
- 호스트 이름: 서버 IP
- 포트: 22
- 사용자 이름 / 비밀번호: 서버 계정 정보
- 저장 → 로그인 클릭. 첫 접속 시 호스트 키 신뢰 여부 확인 창이 뜨면 예 선택.
- 좌측(내 PC) 파일을 우측(서버)으로 드래그하면 업로드, 반대 방향이면 다운로드.
편의 기능: 메뉴 옵션 → 기본 설정 → 통합에서 파일 더블클릭 시 즉시 편집(원격 파일을 로컬 에디터로 열어 저장 시 자동 업로드)이 가능합니다.
크로스 플랫폼 — FileZilla
Windows / Mac / Linux 모두 지원하는 무료 SFTP 클라이언트입니다.
🚀 빠른 접속
- filezilla-project.org에서 FileZilla Client 다운로드 (Server 아님)
- 상단 빠른 연결 바에 입력:호스트:
sftp://111.222.33.44사용자명 / 비밀번호: 서버 계정포트: 22빠른 연결 클릭 - 접속 후 좌측은 로컬, 우측은 서버. 드래그앤드롭으로 전송.
주의: 호스트 입력 시 sftp:// 접두어를 빼먹으면 평문 FTP로 시도될 수 있습니다. 반드시 명시하세요.
자주 겪는 문제
❌ "Permission denied (publickey,password)"
사용자명·비밀번호가 잘못되었거나, 서버에서 비밀번호 인증을 막아둔 경우입니다./etc/ssh/sshd_config의PasswordAuthentication yes를 확인하세요.
❌ 업로드한 파일을 웹에서 못 봄 (403/권한 오류)
업로드한 파일의 소유자/권한 문제입니다. 일반적으로 웹서버(nginx, apache)는www-data 계정으로 동작합니다.
소유자 변경 + 권한 부여
$sudo chown -R www-data:www-data /var/www/html && sudo chmod -R 755 /var/www/html❌ "Connection refused" 또는 타임아웃
포트 22가 방화벽에서 막혀있거나, 서버 SSH 서비스가 중단된 상태입니다. 보안 그룹 / UFW에서 22 포트를 허용했는지 확인하세요.