Lệnh sftp: kết nối, truyền tệp bằng put và get, cách dùng chế độ batch

Môi trường thử nghiệmHọ RHELAlmaLinux 9.8tài khoản người dùng thường
Lệnh mạngsftpVị trí/usr/bin/sftp
Kiểm tra thao tác tải lên và tải xuống tệp trên máy chủ

Lệnh sftp là chương trình truyền tệp của OpenSSH dùng để trao đổi tệp với máy chủ đã kết nối qua SSH; sau khi kết nối, tại dấu nhắc sftp> có thể di chuyển giữa các thư mục từ xa, tải lên bằng put và lấy về bằng get. Khi kết nối bằng xác thực bằng khóa trên máy chủ thử nghiệm AlmaLinux 9, trao đổi tệp và thư mục rồi chạy cả bằng tệp batch -b, tệp cùng tên bị ghi đè mà không hỏi, còn batch dừng ngay tại chỗ khi một lệnh ở giữa thất bại và kết thúc với mã thoát 1.

Đầu ra bên dưới là kết quả nguyên văn nhận được khi tạo tài khoản user1 và admin1 trên máy chủ thử nghiệm AlmaLinux 9, rồi từ admin1 kết nối localhost tới user1 trên cùng máy chủ. Tên kết nối server là tên ví dụ được ghi trong thiết lập SSH của admin1 để nối tới 127.0.0.1, nên các dòng lỗi hiện 127.0.0.1. Tài khoản và tên tệp cũng là giá trị ví dụ; với máy chủ từ xa thực tế thì ghi địa chỉ hoặc tên của máy chủ đó vào vị trí server.

1️⃣ Cách kết nối bằng lệnh sftp

Khi ghi [tài khoản@máy chủ] sau sftp, sftp kết nối qua SSH rồi hiện dấu nhắc sftp>. Trên máy chủ thử nghiệm, khóa ed25519 tạo ở admin1 đã được đăng ký sẵn vào authorized_keys của user1 nên không bị hỏi mật khẩu.

sftp user1@server
The authenticity of host 'server (127.0.0.1)' can't be established.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added 'server' (ED25519) to the list of known hosts.
Connected to server.
sftp> pwd
Remote working directory: /home/user1
sftp> bye

Với máy chủ kết nối lần đầu, sẽ có câu hỏi xác nhận khóa máy chủ, và trên màn hình thực tế, sau dòng đầu tiên còn có thêm một dòng dấu vân tay khóa khác nhau ở mỗi máy chủ (đã lược bỏ trong khung phía trên). Khi nhập yes, máy chủ được thêm vào known_hosts, và sau dòng [Connected to server.] thì dấu nhắc sftp> hiện ra.

pwd in thư mục làm việc từ xa. Để kết thúc kết nối sftp thì nhập bye; exit và quit cũng hoạt động giống bye.

Với tài khoản chưa đăng ký khóa, máy chủ hỏi mật khẩu khi kết nối, và ở chế độ tương tác thì nhập trực tiếp vào câu hỏi này để kết nối. Trên máy chủ thử nghiệm, cùng lệnh đó được chạy sau khi đặt mật khẩu tạm cho user1 trong trạng thái chưa đăng ký khóa của admin1.

sftp user1@server
user1@server's password:
Connected to server.

Mật khẩu đã nhập không hiện trên màn hình, và sau dòng [Connected to server.] thì dấu nhắc sftp> hiện ra.

Với máy chủ đã đổi cổng SSH sang số khác 22, số cổng được chỉ định bằng -P. Trên máy chủ thử nghiệm, một máy chủ SSH nữa được chạy thêm ở cổng 2222, sau đó kết nối bằng -P 2222.

sftp -P 2222 user1@server
Connected to server.
sftp> pwd
Remote working directory: /home/user1
sftp> bye

-P chỉ định cổng là chữ hoa, còn -p chữ thường là tùy chọn giữ nguyên thời gian sửa đổi và quyền của tệp.

Nếu tệp khóa được tạo với tên khác tên mặc định, tệp khóa riêng được chỉ định bằng -i. Bên dưới là kết quả khi kết nối bằng user1_key và chỉ chạy pwd và bye. -b - là chế độ batch đọc lệnh từ đầu vào chuẩn, ở đây chỉ dùng để kiểm tra kết quả kết nối.

sftp -i ~/.ssh/user1_key -b - user1@server
sftp> pwd
Remote working directory: /home/user1
sftp> bye

Khi thêm -v để kiểm tra quá trình kết nối, khóa được thử chỉ có một là user1_key đã chỉ định bằng -i, và việc xác thực diễn ra theo phương thức publickey.

Để thực hiện cùng kết nối SFTP này bằng chương trình GUI như FileZilla, có thể tham khảo bài FTP là gì? (&SFTP) và các bài Cách kết nối SFTP với Cloudways và Cách kết nối SFTP với AWS Lightsail về thiết lập kết nối bằng tài khoản và khóa nhận từ dịch vụ hosting.

2️⃣ Cách dùng sftp và các lệnh cơ bản

ls, cd và pwd chạy tại dấu nhắc sftp> hoạt động trên máy chủ từ xa. Thư mục cục bộ ở phía chạy sftp được thao tác bằng lls, lcd, lpwd có thêm l ở đầu, và tệp cần tải lên được tìm bằng lls.

Các khung bên dưới là kết quả chạy với một lần kết nối mới sau mỗi vài dòng lệnh, nên thư mục làm việc từ xa bắt đầu ở /home/user1, còn thư mục làm việc cục bộ bắt đầu ở /home/admin1.

Khi nhập help, các lệnh dùng được hiện ra kèm mô tả một dòng.

help
Available commands:
bye                                Quit sftp
cd path                            Change remote directory to 'path'
chgrp [-h] grp path                Change group of file 'path' to 'grp'
chmod [-h] mode path               Change permissions of file 'path' to 'mode'
chown [-h] own path                Change owner of file 'path' to 'own'
copy oldpath newpath               Copy remote file
cp oldpath newpath                 Copy remote file
df [-hi] [path]                    Display statistics for current directory or
                                   filesystem containing 'path'
exit                               Quit sftp
get [-afpR] remote [local]         Download file
help                               Display this help text
lcd path                           Change local directory to 'path'
lls [ls-options [path]]            Display local directory listing
lmkdir path                        Create local directory
ln [-s] oldpath newpath            Link remote file (-s for symlink)
lpwd                               Print local working directory
ls [-1afhlnrSt] [path]             Display remote directory listing
lumask umask                       Set local umask to 'umask'
mkdir path                         Create remote directory
progress                           Toggle display of progress meter
put [-afpR] local [remote]         Upload file
pwd                                Display remote working directory
quit                               Quit sftp
reget [-fpR] remote [local]        Resume download file
rename oldpath newpath             Rename remote file
reput [-fpR] local [remote]        Resume upload file
rm path                            Delete remote file
rmdir path                         Remove remote directory
symlink oldpath newpath            Symlink remote file
version                            Show SFTP version
!command                           Execute 'command' in local shell
!                                  Escape to local shell
?                                  Synonym for help

Trong danh sách, bye, exit và quit đều có cùng mô tả là [Quit sftp].

ls in danh sách của thư mục làm việc từ xa, và khi thêm -l thì quyền, chủ sở hữu, kích thước và thời gian sửa đổi cũng hiện ra.

ls
config     docs       draft.txt  logs       memo.txt   notes.txt  old.txt    
run.sh     
ls -l
drwxr-xr-x    ? user1    user1        4096 Jan  1  2026 config
drwxr-xr-x    ? user1    user1        4096 Jan  1  2026 docs
-rw-r--r--    ? user1    user1           6 Jan  1  2026 draft.txt
drwxr-xr-x    ? user1    user1        4096 Jan  1  2026 logs
-rw-r--r--    ? user1    user1          10 Jan  1  2026 memo.txt
-rw-r--r--    ? user1    user1          13 Jan  1  2026 notes.txt
-rw-r--r--    ? user1    user1           4 Jan  1  2026 old.txt
-rw-r--r--    ? user1    user1          18 Jan  1  2026 run.sh

Thư mục làm việc từ xa được đổi sang docs bằng cd rồi kiểm tra bằng pwd.

cd docs
pwd
Remote working directory: /home/user1/docs

Ở phía cục bộ, lpwd dùng để kiểm tra thư mục hiện tại và lls in danh sách. Sau lls có thể thêm nguyên các tùy chọn của ls cục bộ nên lls -l cũng chạy được.

lpwd
Local working directory: /home/admin1
lls
memo.txt
report.txt
site
lls -l
total 12
-rw-r--r--. 1 admin1 admin1    9 Jan  1  2026 memo.txt
-rw-r--r--. 1 admin1 admin1   15 Jan  1  2026 report.txt
drwxr-xr-x. 3 admin1 admin1 4096 Jan  1  2026 site

Khi đổi thư mục làm việc cục bộ sang site bằng lcd, đường dẫn của lpwd cũng đổi thành /home/admin1/site.

lcd site
lpwd
Local working directory: /home/admin1/site

Thư mục từ xa được tạo bằng mkdir và xóa bằng rmdir. Sau khi tạo và sau khi xóa, danh sách được kiểm tra bằng ls.

mkdir backup
ls
backup     config     docs       draft.txt  logs       memo.txt   notes.txt  
old.txt    run.sh     
rmdir backup
ls
config     docs       draft.txt  logs       memo.txt   notes.txt  old.txt    
run.sh     

Tệp được xóa bằng rm và đổi tên bằng rename. Sau khi xóa old.txt, draft.txt được đổi thành final.txt.

rm old.txt
ls
config     docs       draft.txt  logs       memo.txt   notes.txt  run.sh     
rename draft.txt final.txt
ls
config     docs       final.txt  logs       memo.txt   notes.txt  run.sh     

chmod đổi quyền của tệp từ xa. Khi đổi run.sh thành 755, cột quyền của ls -l đổi thành -rwxr-xr-x.

ls -l run.sh
-rw-r--r--    ? user1    user1          18 Jan  1  2026 run.sh
chmod 755 run.sh
ls -l run.sh
-rwxr-xr-x    ? user1    user1          18 Jan  1  2026 run.sh

Với notes.txt, quyền được đổi thành 600 để chỉ chủ sở hữu đọc và ghi được.

chmod 600 notes.txt
ls -l notes.txt
-rw-------    ? user1    user1          13 Jan  1  2026 notes.txt

df in dung lượng của hệ thống tệp từ xa. Khi thêm -h, kết quả hiện theo đơn vị GB.

df -h
    Size     Used    Avail   (root)    %Capacity
  23.1GB    6.2GB   15.8GB   16.9GB          26%

Khi thêm ! trước một lệnh, lệnh đó chạy trong shell cục bộ. Với !ls -l, các tệp cục bộ trong thư mục home của admin1 hiện ra.

!ls -l
total 12
-rw-r--r--. 1 admin1 admin1    9 Jan  1  2026 memo.txt
-rw-r--r--. 1 admin1 admin1   15 Jan  1  2026 report.txt
drwxr-xr-x. 3 admin1 admin1 4096 Jan  1  2026 site
!pwd
/home/admin1

Nếu chỉ nhập một dấu !, sftp thoát ra shell cục bộ, và khi nhập exit thì quay lại dấu nhắc sftp>.

3️⃣ Tải lên và tải xuống tệp bằng sftp

put tải tệp cục bộ lên thư mục làm việc từ xa, còn get lấy tệp từ xa về thư mục làm việc cục bộ. Trước hết, tệp 50MB backup.tar.gz được tạo bằng head -c.

head -c 50M /dev/urandom > backup.tar.gz

Khi tải tệp này lên ở chế độ tương tác, trước tiên hiện một dòng cho biết tải lên đường dẫn nào, và dòng bên dưới hiện tên tệp, tiến độ, kích thước, tốc độ và thời gian đã dùng.

put backup.tar.gz
Uploading backup.tar.gz to /home/user1/backup.tar.gz
backup.tar.gz                                 100%   50MB  92.5MB/s   00:00    

Với get, nếu ghi một tên khác ở phía sau thì tệp được lưu bằng tên đó.

get backup.tar.gz restore.tar.gz
Fetching /home/user1/backup.tar.gz to restore.tar.gz
backup.tar.gz                                 100%   50MB 194.3MB/s   00:00    

cmp không in gì khi hai tệp giống nhau nên echo được thêm ở phía sau, và khi so sánh tệp đã tải lên với tệp nhận lại thì same hiện ra.

cmp backup.tar.gz restore.tar.gz && echo same
same

Khi chạy put và get ở chế độ batch để tải report.txt lên và nhận notes.txt, ngoài các dòng lệnh sftp> thì không có dòng kết quả nào. Tệp đã nhận được kiểm tra bằng lls -l, và notes.txt đã đổi quyền thành 600 ở phần trước vẫn giữ quyền 600 dù nhận không có -p.

Thư mục chỉ được truyền khi thêm -r. Khi tải thư mục site lên mà không có -r, lỗi báo đó không phải tệp thông thường hiện ra.

put site
local "site/" is not a regular file
put -r site
Entering site/
Entering site/css

Khi thêm -r, mỗi thư mục có một dòng Entering, và dưới site từ xa có thư mục css cùng index.html, dưới css có style.css được tải lên. Khi nhận thư mục từ xa cũng thêm -r vào get.

get -r logs
Retrieving /home/user1/logs

Khi kiểm tra bằng lls -l logs, app.log và error.log đã được tải về. Khi thử nhận thư mục docs mà không có -r, get cũng kết thúc bằng lỗi [not a regular file].

get docs
download /home/user1/docs/: not a regular file

Khi thêm -p, thời gian sửa đổi và quyền của tệp gốc được giữ nguyên. Sau khi đặt thời gian sửa đổi của report.txt cục bộ thành ngày 1 tháng 1, tệp được tải lên bằng -p với tên report-p.txt.

put -p report.txt report-p.txt
ls -l report-p.txt
-rw-r--r--    ? user1    user1          15 Jan  1  2026 report-p.txt

report-p.txt giữ nguyên thời gian sửa đổi của tệp gốc, còn report.txt đã tải lên không có -p ở phần trước thì đổi thành thời gian tải lên. readme.txt nhận bằng get -p cũng giữ được thời gian sửa đổi của tệp từ xa.

get -p docs/readme.txt
lls -l readme.txt
-rw-r--r--. 1 admin1 admin1 7 Jan  1  2026 readme.txt

Ngay cả khi đã có tệp cùng tên, put vẫn ghi đè mà không hỏi. Trước hết, nội dung của memo.txt cục bộ và memo.txt từ xa được kiểm tra.

cat memo.txt
local v2
ssh user1@server cat memo.txt
remote v1
put memo.txt
ssh user1@server cat memo.txt
local v2

memo.txt từ xa đổi thành nội dung cục bộ mà không có câu hỏi xác nhận, và put chạy ở chế độ tương tác cũng tải lên ngay mà không hỏi. Nếu có tệp từ xa cần giữ lại thì ghi một tên khác sau put để tải lên.

Việc gửi vài tệp một lần thì lệnh scp cũng làm xong trong một dòng, còn việc đồng bộ lặp lại cùng một thư mục thì hợp với lệnh rsync, lệnh chỉ gửi các tệp đã thay đổi. sftp phù hợp khi vừa giữ kết nối vừa xem danh sách từ xa để chọn tệp cần chuyển, hoặc khi chạy lần lượt nhiều lệnh bằng tệp batch. Trên máy chủ thử nghiệm, sftp và scp nằm trong cùng gói openssh-clients, còn rsync thuộc gói rsync.

LệnhPhù hợp với
sshKết nối tới máy chủ từ xa bằng shell hoặc chạy lệnh từ xa
sftpVừa giữ kết nối vừa xem danh sách từ xa để tải tệp lên và nhận về, chạy nhiều lệnh bằng tệp batch
scpSao chép tệp và thư mục bằng một dòng lệnh
rsyncSo sánh nguồn với đích và chỉ truyền các tệp đã thay đổi

4️⃣ Chế độ batch của sftp

Cách nhập put và get từng dòng tại dấu nhắc sftp> không dùng nguyên như vậy được trong cron hay shell script. Khi chỉ định cho -b một tệp ghi các lệnh, sftp chạy lần lượt các lệnh trong tệp đó rồi kết thúc. Chế độ batch không nhập được mật khẩu, nên tài liệu hướng dẫn cũng chỉ dẫn dùng cùng với cách xác thực không cần nhập như xác thực bằng khóa.

upload.batch là tệp batch tải report.txt lên thư mục public_html từ xa. Trước khi chạy tệp batch, thư mục public_html từ xa phải tồn tại. Trong bài này, thư mục đó được tạo trước bằng [put -r site public_html] ở phần ví dụ thực tế bên dưới.

cat upload.batch
cd public_html
put report.txt
ls -l

Tệp này được chạy bằng -b, và giống như trong script, đầu ra bị bỏ đi còn việc thành công hay không được kiểm tra bằng mã thoát.

if sftp -b upload.batch user1@server > /dev/null; then echo "upload OK"; else echo "upload FAILED (rc=$?)"; fi
upload OK

Nếu một lệnh ở giữa tệp batch thất bại, sftp dừng ngay tại chỗ đó. Điều này được kiểm tra bằng fail.batch có chứa cd nodir, lệnh chuyển tới một thư mục không tồn tại.

cat fail.batch
cd public_html
cd nodir
put memo.txt
ls -l
sftp -b fail.batch user1@server; echo "rc=$?"
sftp> cd public_html
sftp> cd nodir
stat remote: No such file or directory
rc=1

Sau khi lỗi [No such file or directory] xảy ra ở cd nodir, put và ls không được chạy, và mã thoát là 1. Tài liệu hướng dẫn giải thích rằng batch dừng lại khi các lệnh như cd, get, put, rm, ls thất bại. Khi chạy câu lệnh if với cùng tệp đó, [upload FAILED (rc=1)] hiện ra.

if sftp -b fail.batch user1@server > /dev/null; then echo "upload OK"; else echo "upload FAILED (rc=$?)"; fi
stat remote: No such file or directory
upload FAILED (rc=1)

Lệnh nào cần chuyển sang dòng tiếp theo dù thất bại thì thêm - ở phía trước. Ở đây chạy fail-dash.batch, trong đó chỉ cd nodir của fail.batch được đổi thành -cd nodir.

cat fail-dash.batch
cd public_html
-cd nodir
put memo.txt
ls -l
sftp -b fail-dash.batch user1@server
sftp> cd public_html
sftp> -cd nodir
stat remote: No such file or directory
sftp> put memo.txt
sftp> ls -l

Ở -cd nodir cũng xảy ra cùng lỗi đó, nhưng put memo.txt và ls -l ở các dòng tiếp theo vẫn được chạy, và mã thoát là 0. Trong khung phía trên, các dòng danh sách của ls -l có ghi ngày và giờ đã được lược bỏ, và trong danh sách đó có memo.txt đã được tải lên.

Khi đưa lệnh vào bằng đầu vào chuẩn thay cho tệp thì dùng -b -. Trong shell script, lệnh được đưa vào bằng here document như bên dưới, và các lệnh mà sftp đã chạy cũng hiện ra dưới dạng dòng sftp>. Trong danh sách cũng có memo.txt đã tải lên bằng fail-dash.batch.

sftp -b - user1@server <<'EOF'
cd public_html
ls
EOF
sftp> cd public_html
sftp> ls
css          index.html   memo.txt     report.txt   

Chế độ batch không trả lời được câu hỏi, nên với máy chủ kết nối lần đầu thì thất bại ở bước xác nhận khóa máy chủ. Khi kết nối bằng tên localhost không có trong known_hosts, [Host key verification failed.] hiện ra và mã thoát là 255.

sftp -b - user1@localhost
Host key verification failed.
Connection closed

Vì vậy, với máy chủ mà script kết nối lần đầu, trước hết cần kết nối một lần bằng sftp hoặc ssh ở chế độ tương tác để đăng ký khóa máy chủ vào known_hosts.

🔲 Tùy chọn của lệnh sftp

Tùy chọnSao chépMô tả
-PChỉ định số cổng của máy chủ SSH để kết nối
-iChỉ định tệp khóa riêng dùng cho xác thực khóa công khai
-bChạy lần lượt các lệnh trong tệp batch và dừng ở lệnh thất bại
-b -Đọc lệnh batch từ đầu vào chuẩn
-vIn quá trình kết nối thành các dòng debug1
put -rTải thư mục cục bộ lên, kể cả thư mục con
get -rTải thư mục từ xa xuống, kể cả thư mục con
put -pTải lên và giữ nguyên thời gian sửa đổi và quyền
get -pTải xuống và giữ nguyên thời gian sửa đổi và quyền
ls -lIn danh sách từ xa kèm quyền, chủ sở hữu, kích thước, thời gian sửa đổi
df -hIn dung lượng hệ thống tệp từ xa theo đơn vị như GB
!lệnhChạy lệnh trong shell cục bộ, chỉ nhập một dấu ! thì chuyển sang shell cục bộ
Tùy chọnSao chépMô tả
-4Chỉ kết nối bằng địa chỉ IPv4
-6Chỉ kết nối bằng địa chỉ IPv6
-aTruyền tiếp lượt truyền bị gián đoạn mà không ghi đè
-CBật nén bằng -C của ssh rồi truyền
-FChỉ định tệp cấu hình người dùng mà ssh sẽ đọc
-JKết nối tới máy chủ đích qua jump host
-lGiới hạn băng thông truyền theo đơn vị Kbit/s
-NTắt chế độ im lặng do -b bật
-oChỉ định tùy chọn ssh theo định dạng ssh_config
-pTruyền và giữ nguyên thời gian sửa đổi, thời gian truy cập, quyền của tệp
-qKhông in dòng tiến độ cùng cảnh báo và thông báo chẩn đoán của ssh
-rTruyền thư mục, kể cả thư mục con
ls -aIn cả các tệp bắt đầu bằng dấu chấm (.)
ls -tSắp xếp theo thứ tự thời gian sửa đổi
regetNhận tiếp lượt tải xuống bị gián đoạn (giống get -a)
reputTải tiếp lượt tải lên bị gián đoạn (giống put -a)
lmkdirTạo thư mục cục bộ
progressBật hoặc tắt dòng tiến độ

🔲 Trình mô phỏng lệnh sftp

Trong trình mô phỏng bên dưới, khi nhập bằng chip hoặc bàn phím lệnh kết nối sftp đã chạy trong bài và các lệnh tại dấu nhắc sftp>, có thể xem cùng đầu ra. put và get chạy ở chế độ tương tác hiện cả dòng Uploading, Fetching và dòng tiến độ. Trình mô phỏng bắt đầu ở trạng thái đã đăng ký khóa, nên [sftp user1@server] trong khung kết nối bằng mật khẩu cũng kết nối được mà không hỏi mật khẩu.

Trình mô phỏng lệnh sftpAlmaLinux 9.8
[root@server work]#
Chỉ chạy trong trình duyệt. Việc truyền và xóa tệp chỉ là mô phỏng, chỉ thay đổi trạng thái của máy chủ ảo trên màn hình này.

5️⃣ Ví dụ thực tế về lệnh sftp

  • ↪️ Sao lưu tệp cấu hình và tải lên thư mục web, nhầm lẫn khi kết nối và cách đọc lỗi

Kết nối và các lệnh cơ bản có thể nhập thử trực tiếp ở phía trên, trong Trình mô phỏng lệnh sftp.

🔲 Sao lưu tệp cấu hình và tải lên thư mục bằng sftp

Trước khi sửa tệp cấu hình từ xa, nếu nhận về sẵn bằng một tên khác thì có thể dùng khi cần khôi phục. app.conf được nhận về thành app.conf.bak bằng cách ghi tên lưu sau get, và nội dung đã nhận được kiểm tra bằng !cat.

get config/app.conf app.conf.bak
!cat app.conf.bak
port=8080
log=/var/log/app.log

Khi tải lên nguyên cả thư mục web, tên thư mục từ xa được ghi sau put -r. Khi ghi tên public_html chưa có ở phía từ xa, thư mục được tạo với tên đó, và khi kiểm tra bằng ls -l thì thư mục css và index.html trong site nằm ngay dưới public_html.

put -r site public_html
Entering site/
Entering site/css

Nếu ghi tên thư mục đã tồn tại thì cả thư mục site được tải lên dưới thư mục đó. Sau khi tạo www bằng mkdir rồi chạy theo cùng dạng, đường dẫn của index.html trở thành www/site/index.html.

mkdir www
put -r site www
Entering site/
Entering site/css

Nếu thư mục từ xa đã có thì cả thư mục được tải lên, nếu chưa có thì chỉ nội dung được tải lên, nên trước khi tải lên cần dùng ls để kiểm tra trước xem thư mục từ xa có tồn tại không.

🔲 Lỗi thường gặp khi dùng sftp

Nếu ghi ở -P một số khác với cổng SSH của máy chủ thì lệnh kết thúc ngay ở bước kết nối. Ở đây kết nối bằng -P 2222 trong trạng thái không có máy chủ SSH ở cổng 2222.

sftp -P 2222 user1@server
ssh: connect to host 127.0.0.1 port 2222: Connection refused
Connection closed

Không có máy chủ SSH nào chờ ở cổng đó nên [Connection refused] hiện ra và mã thoát là 255. Khi gặp lỗi này, trước tiên cần kiểm tra số ghi ở -P có trùng với cổng SSH của máy chủ không.

Nếu để tệp khóa riêng mở cho cả người dùng khác đọc được thì ssh không dùng khóa đó. Ở đây kết nối sau khi đổi quyền của khóa mặc định id_ed25519 thành 644.

chmod 644 ~/.ssh/id_ed25519
sftp -b - user1@server
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@         WARNING: UNPROTECTED PRIVATE KEY FILE!          @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/home/admin1/.ssh/id_ed25519' are too open.
It is required that your private key files are NOT accessible by others.
This private key will be ignored.
Load key "/home/admin1/.ssh/id_ed25519": bad permissions
user1@127.0.0.1: Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password).
Connection closed

Khóa bị bỏ qua kèm cảnh báo [UNPROTECTED PRIVATE KEY FILE], và vì không có phương thức xác thực nào khác nên lệnh kết thúc bằng [Permission denied]. Khi đổi quyền về lại 600, cùng lệnh đó kết nối được.

chmod 600 ~/.ssh/id_ed25519
sftp -b - user1@server
sftp> pwd
Remote working directory: /home/user1
sftp> bye

Khi khóa chỉ định bằng -i có quyền 644, cùng cảnh báo đó cũng hiện ra, và lúc này dù khóa mặc định id_ed25519 có quyền 600 thì ssh cũng không thử khóa đó nên không kết nối được.

Khi xác thực thất bại nhiều lần trong thời gian ngắn, dù kết nối lại bằng user1_key đã chỉ định bằng -i ngay sau khi đổi quyền của khóa đó về lại 600, kết nối vẫn bị ngắt trước khi xác thực.

sftp -i ~/.ssh/user1_key -b - user1@server
Connection closed by 127.0.0.1 port 22
Connection closed

Trên máy chủ thử nghiệm OpenSSH 9.9p1, nhật ký máy chủ ghi lại dòng [penalty: failed authentication], và khoảng 1 phút 25 giây sau thì kết nối được bằng cùng lệnh đó.

Ghi sai tên tài khoản cũng cho ra cùng dòng [Permission denied]. Đây là kết quả khi ghi user1 thành usr1.

sftp -b - usr1@server
usr1@127.0.0.1: Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password).
Connection closed

Đầu ra giống với khi khóa có vấn đề, nên khi dòng này hiện ra, trước tiên cần kiểm tra tên tài khoản trước @ cùng với tệp khóa.

Nếu ghi sai đường dẫn từ xa thì put cũng thất bại. Ở đây đường dẫn có chứa tên tài khoản /home/user1 được ghi thành /home/usr1.

put report.txt /home/usr1/report.txt
dest open "/home/usr1/report.txt": No such file or directory

Khi ghi một thư mục không tồn tại vào đường dẫn cục bộ để nhận bằng get thì gặp lỗi [open local].

get notes.txt nodir/notes.txt
open local "nodir/notes.txt": No such file or directory

get cũng ghi đè mà không hỏi nếu phía cục bộ có tệp cùng tên. Sau khi sửa notes.txt cục bộ, notes.txt từ xa được nhận về bằng get.

echo "local edit" > notes.txt
cat notes.txt
local edit
get notes.txt
cat notes.txt
remote notes

Nội dung đã sửa ở phía cục bộ bị đổi thành nội dung của tệp từ xa. Để giữ lại tệp cục bộ thì ghi một tên lưu khác sau get.

🔲 Kiểm tra đầu ra và mã thoát của sftp

Với ls -l của sftp, cột thứ hai hiện ? thay cho số liên kết. lls -l, vốn chạy nguyên ls cục bộ, hiện số liên kết ở cột đó (tệp 1, thư mục site 3), và cuối phần quyền có thêm dấu chấm (.). Vì vậy, nếu cột thứ hai là ? thì đó là danh sách từ xa, nếu là số thì đó là danh sách cục bộ.

Ở chế độ batch, chmod không có dòng kết quả nào ngoài dòng lệnh sftp>, còn ở chế độ tương tác, khi đổi quyền của tmpdir tạo bằng mkdir thì có một dòng [Changing mode on] hiện ra.

mkdir tmpdir
chmod 700 tmpdir
Changing mode on /home/user1/tmpdir

Dòng [Connected to server.] cùng các dòng Uploading, Fetching của put, get không hiện ra ở chế độ batch -b. Lý do là, như phần mô tả -N trong tài liệu hướng dẫn, -b bật luôn cả chế độ im lặng.

Nhìn vào phần đầu của dòng lỗi là biết lỗi xảy ra ở phía từ xa hay phía cục bộ. Lỗi cd từ xa là [stat remote], còn khi put một tệp không có ở phía cục bộ thì hiện [stat nolocal.txt], trong đó tên tệp đó nằm ở vị trí của remote.

cd nodir
stat remote: No such file or directory
put nolocal.txt
stat nolocal.txt: No such file or directory

Khi get một tệp không có ở phía từ xa, lệnh kết thúc bằng [not found.] kèm đường dẫn đầy đủ phía từ xa.

get nofile.txt
File "/home/user1/nofile.txt" not found.

Mã thoát là 255 khi thất bại ở bước kết nối, là 1 khi cd, put, get của batch thất bại sau khi kết nối, và trong script, giá trị này được dùng để phân biệt lệnh đã dừng ở bước nào. Tuy nhiên, ls chạy không có đối số sau cd /root vẫn có mã thoát 0 dù hiện [Permission denied], nên với batch đọc danh sách thì cần kiểm tra cả đầu ra.

🔢 FAQ & nội dung đề xuất

Nếu thêm dấu hai chấm và đường dẫn từ xa sau địa chỉ thì sftp kết nối, chỉ nhận tệp đó rồi kết thúc. Khi chạy [sftp user1@server:config/app.conf app.conf.copy], sau [Connected to server.] thì [Fetching /home/user1/config/app.conf to app.conf.copy] hiện ra và lệnh kết thúc với mã thoát 0. Nếu đường dẫn là thư mục thì sau khi kết nối, sftp bắt đầu ở thư mục đó. Khi kết nối bằng [user1@server:docs] rồi chạy pwd, /home/user1/docs hiện ra.

rmdir chỉ xóa thư mục rỗng. Khi chạy [rmdir docs] với thư mục docs có chứa readme.txt và guide.txt, lệnh kết thúc bằng [Failure]. rm trong danh sách help là lệnh xóa tệp từ xa, nên để xóa thư mục thì trước hết xóa các tệp bên trong bằng rm rồi mới chạy rmdir.

sftp hoạt động với quyền của tài khoản từ xa đã kết nối. Khi chạy [ls /root] bằng user1, [Permission denied] hiện ra, và [get /etc/shadow] cũng kết thúc với cùng lỗi đó ở bước [remote open]. [cd /root] chuyển thư mục mà không báo lỗi, nhưng khi chạy ls tại đó thì [Permission denied] hiện ra thay cho danh sách.

ℹ️ Thông báo tiếp thị liên kết
Nội dung trên trang này có chứa liên kết affiliate (tiếp thị liên kết). Khi khách truy cập mua sản phẩm hoặc dịch vụ qua các liên kết này, trang sẽ nhận hoa hồng từ bên bán. Trong quá trình đó, số tiền người mua phải trả (sẽ giảm khi có chương trình khuyến mãi ↓) không hề tăng lên. Giá, khuyến mãi và tình trạng hàng được đăng theo thời điểm viết bài và có thể khác với thực tế, vì vậy hãy kiểm tra lại lần cuối với bên bán trước khi mua. Việc chọn và đánh giá sản phẩm dựa trên tiêu chí riêng của trang; việc có nhận hoa hồng hay không không ảnh hưởng đến thứ tự giới thiệu hay nội dung đánh giá.

Để lại một bình luận

Email của bạn sẽ không được hiển thị công khai. Các trường bắt buộc được đánh dấu *

Prove your humanity: 8   +   9   =