WinSCP는 Windows에서 Linux 서버나 Raspberry Pi로 파일을 보내고 받을 수 있는 프로그램입니다. 이 글에서는 암호화된 SFTP 연결로 파일 하나를 업로드하고 내려받는 과정을 설명합니다.
첨부한 WinSCP-6.5.7-Portable.zip은 공식 원본 포터블 배포본입니다. WinSCP-guide-ko.zip에는 한국어 설명서와 전송 연습 파일이 있습니다. WinSCP-6.5.7-Source.zip은 같은 버전의 공식 소스 코드이며 일반 실행에는 필요하지 않습니다.
1. 압축 해제와 실행
- Portable ZIP을 내려받아 쓸 수 있는 폴더에 전체 압축을 풉니다.
WinSCP.exe를 실행합니다. 별도 설치 마법사는 필요하지 않습니다.- 처음 사용하는 경우 로컬·원격 파일을 나란히 보는 Commander 화면을 선택합니다.
설정은 실행 환경에 따라 INI 파일이나 기존 설정을 사용할 수 있습니다. 이동식 저장장치에서 사용한다면 공식 포터블 설정 안내도 확인하세요.
이 자료는 6.5.7 안정판을 기준으로 하며 공식 ReadMe의 SHA-256과 첨부 원본을 대조했습니다. 다른 운영 환경이나 이후 버전은 공식 다운로드에서 확인할 수 있습니다.
2. SFTP 로그인
| 로그인 항목 | 입력할 값 |
|---|---|
| File protocol | SFTP |
| Host name | 접속할 서버의 IP 또는 호스트 이름 |
| Port number | 보통 22, 서버 설정이 다르면 지정된 포트 |
| User name | 서버에 실제로 만든 사용자 계정 |
| Password / Private key | 해당 서버가 허용하는 인증 방식 |
- New Site에서 위 항목을 입력합니다. Raspberry Pi도 Imager에서 만든 사용자 이름을 사용합니다.
- 키 인증을 사용하는 경우 Advanced의 SSH 인증 설정에서 해당 개인 키를 지정합니다.
- Login을 누릅니다. 처음 나오는 서버 호스트 키 지문은 관리자나 서버 콘솔에서 확인한 지문과 비교한 후 신뢰합니다.
- 연결되면 오른쪽 창에 원격 계정의 디렉터리가 표시되는지 확인합니다.
호스트 키가 예전과 달라졌다는 경고가 나오면 서버 재설치 등 변경 이유를 먼저 확인합니다. 공식 접속 안내
3. 파일 하나 업로드하기
- 설명서 ZIP의
hello-upload.txt를 로컬 폴더에 압축 해제합니다. - Commander 화면의 왼쪽에서 해당 로컬 폴더를 엽니다.
- 오른쪽에서 원격 사용자 홈 아래에
transfer-test같은 연습용 폴더를 만들어 엽니다. - 왼쪽 파일을 선택하고 Upload를 누르거나 오른쪽으로 끌어놓습니다.
- 대상 경로를 확인하고 전송합니다. 같은 이름의 파일이 있다면 덮어쓰기 전에 기존 파일이 필요한지 확인합니다.
- 오른쪽 목록을 새로 고쳐 파일 이름과 크기를 확인합니다.
펌웨어 BIN·ZIP·이미지처럼 바이트를 그대로 보존해야 하는 파일은 전송 모드를 Binary로 지정합니다. 자세한 화면 설명은 공식 업로드 안내를 참고하세요.
4. 다운로드와 전송 결과 확인
- 왼쪽에서 내려받을 별도의 로컬 폴더를 엽니다.
- 오른쪽 원격 파일을 선택하고 Download를 실행합니다.
- 원본과 내려받은 파일의 크기를 비교합니다.
- BIN·배포 파일은 양쪽 파일의 SHA-256도 비교하면 내용이 같은지 확인할 수 있습니다.
Windows PowerShell에서 아래 명령은 파일을 수정하지 않고 해시를 계산합니다. 파일명은 실제 경로로 바꿉니다.
Get-FileHash -Algorithm SHA256 -LiteralPath '.\hello-upload.txt'전체 폴더 동기화를 사용하기 전에는 전송 방향과 삭제 옵션, 미리보기 목록을 확인합니다. 처음에는 위와 같이 파일 하나로 경로와 권한을 확인하는 편이 쉽습니다.
5. 연결과 권한 문제
- Connection refused: 서버의 SSH/SFTP 서비스와 포트를 확인합니다.
- Timeout: IP, 네트워크 경로, 방화벽과 VPN 연결을 확인합니다.
- Authentication failed: 사용자 이름, 암호 또는 키·키 암호와 서버의 인증 허용 설정을 확인합니다.
- Permission denied: 현재 계정이 쓸 수 있는 디렉터리인지 확인합니다. 먼저 자기 홈 폴더에서 시험하고 필요한 권한만 관리자에게 요청합니다.
- 파일이 다른 곳에 보임: 왼쪽 로컬 경로와 오른쪽 원격 경로를 다시 확인합니다.
6. 첨부 자료와 공식 출처
- Portable ZIP: 공식 실행 파일과 원본 라이선스.
- Source ZIP: 동일 버전의 공식 소스 배포본. 빌드하지 않고도 Portable을 실행할 수 있습니다.
- 사용법 ZIP: 오프라인 설명서,
hello-upload.txt,transfer-checklist.txt. - 공식 다운로드·소스 · 공식 6.5.7 체크섬 · 라이선스
자료 확인일: 2026년 9월 12일. WinSCP는 GPLv3 이상 조건으로 배포됩니다. 원본 ZIP은 변경하지 않았으며 한국어 설명서는 별도로 제공합니다.