Linux sftp 명령어

sftp(SSH File Transfer Protocol)는 SSH 연결 위에서 동작하는 file 전송 도구로, 암호화된 channel을 통해 안전하게 file을 주고받을 수 있습니다.

sftp 명령어

• sftp(SSH File Transfer Protocol)는 SSH 연결을 통해 file을 전송하는 명령어입니다.
  • SSH의 암호화된 channel을 사용하므로 data가 안전하게 전송됩니다.
  • 기본 port는 SSH와 동일한 22번입니다.
  • interactive mode로 동작하며, FTP와 유사한 명령어 체계를 가집니다.

연결 방법

• sftp 명령어로 원격 server에 연결합니다.

기본 연결

• 사용자 이름과 host를 지정하여 연결합니다.

sftp user@hostname
sftp user@192.168.1.100

Port 지정 연결

• 기본 port(22)가 아닌 다른 port를 사용하는 경우 -P option을 지정합니다.

sftp -P 2222 user@hostname

• -P는 대문자입니다.
  • ssh의 -p(소문자)와 다르므로 주의가 필요합니다.

SSH Key 지정 연결

• 특정 private key file을 사용하여 연결합니다.

sftp -i ~/.ssh/my_key user@hostname

탐색 명령어

• pwd, ls, cd로 원격 server를, lpwd, lls, lcd로 local system을 탐색합니다.

원격 Server 탐색

• 원격 server의 directory와 file을 탐색합니다.

Local System 탐색

• local system의 directory와 file을 탐색합니다.
  • 명령어 앞에 l(local)을 붙입니다.

File 전송 명령어

• get으로 download하고, put으로 upload하며, mget과 mput으로 여러 file을 한 번에 전송합니다.

Download (원격 → Local)

• get 명령어로 원격 server의 file을 local로 download합니다.

# 단일 file download
get remote_file.txt

# 다른 이름으로 저장
get remote_file.txt local_file.txt

# directory 전체 download (-r : recursive)
get -r remote_directory

Upload (Local → 원격)

• put 명령어로 local file을 원격 server에 upload합니다.

# 단일 file upload
put local_file.txt

# 다른 이름으로 저장
put local_file.txt remote_file.txt

# directory 전체 upload (-r : recursive)
put -r local_directory

다중 File 전송

• mget과 mput 명령어로 여러 file을 한 번에 전송합니다.

# 여러 file download
mget *.txt
mget file1.txt file2.txt file3.txt

# 여러 file upload
mput *.log
mput report1.pdf report2.pdf

File 관리 명령어

• mkdir, rmdir, rm, rename, chmod 등으로 원격 server의 file과 directory를 관리합니다.

Session 제어

• bye로 session을 종료하고, !로 local shell 명령어를 실행합니다.

# local에서 명령어 실행 후 sftp로 복귀
sftp> !ls -la /tmp
sftp> !whoami

자주 사용하는 예시

• log file download, 설정 file backup 및 교체, directory 전체 복사 등의 작업을 수행할 수 있습니다.

Log File Download

• 원격 server의 log file을 local로 가져옵니다.

sftp> cd /var/log
sftp> get application.log
sftp> mget *.log

설정 File Backup 및 Upload

• 설정 file을 backup하고 새 file을 upload합니다.

sftp> cd /etc/nginx
sftp> get nginx.conf nginx.conf.backup
sftp> put nginx.conf.new nginx.conf

Directory 전체 복사

• directory 전체를 recursive하게 전송합니다.

# Download
sftp> get -r /home/user/project

# Upload
sftp> put -r ./deploy /var/www/html

Batch Mode

• -b option을 사용하면 command file을 읽어 자동으로 실행합니다.
  • script에서 자동화된 file 전송에 유용합니다.

# commands.txt 내용
cd /var/log
get application.log
bye

sftp -b commands.txt user@hostname

• password 입력 없이 실행하려면 SSH key 인증을 설정해야 합니다.

FTP와의 비교

• sftp는 전통적인 FTP와 protocol 구조와 보안 수준에서 차이가 있습니다.

• FTP는 보안이 취약하여 현대 환경에서는 sftp 또는 FTPS(FTP over SSL) 사용이 권장됩니다.

Reference

• https://man7.org/linux/man-pages/man1/sftp.1.html
• https://www.ssh.com/academy/ssh/sftp