lftp 是功能強大的命令行文件傳輸客戶端,支援 FTP、FTPS (FTP over SSL/TLS)、SFTP、HTTP/HTTPS、BitTorrent、Fish 等協議。相比傳統 ftp/sftp,lftp 提供 **多線程並行傳輸、斷點續傳、鏡像同步、腳本自動化、編輯器式交互界面、配書籤/別名** 等高級功能,是 Linux 運維、備份、部署、數據遷移的利器。
| 發行版 | 安裝命令 |
|---|---|
| CentOS/RHEL/Rocky/AlmaLinux | yum install -y lftp 或 dnf install -y lftp |
| Debian/Ubuntu | apt update && apt install -y lftp |
| Fedora | dnf install -y lftp |
| Arch Linux | pacman -S lftp |
# 交互模式連接 (推薦,支援 Tab 補全、歷史、編輯)
lftp -u username,password ftp://server.ip.or.domain
lftp -u username,password sftp://server.ip.or.domain
lftp -u username,password ftps://server.ip.or.domain # 隱式 FTPS (端口 990)
lftp -u username,password ftp://server.ip.or.domain:2121 # 非標準端口
# 密碼含特殊字符時用單引號包裹或轉義
lftp -u 'user','p@ss!word' ftp://host
# 直接執行命令並退出 (腳本模式)
lftp -c "open -u user,pass ftp://host; mirror -R /local/dir /remote/dir; bye"
| 分類 | 命令 | 說明 | 關鍵參數/範例 |
|---|---|---|---|
| 目錄同步 (殺手鋒功能) | mirror | **遞歸鏡像同步** (下載/上傳整個目錄樹),支援增量、刪除、並行、過濾 | mirror -R /local /remote (上傳/反向鏡像)mirror --parallel=5 --delete --exclude-glob *.log /local /remote |
mirror -R | 反向鏡像 (上傳本地目錄到遠端) | mirror -R -v --parallel=10 --exclude .git /data/backup /remote/backup | |
mirror --dry-run | 預演模式,僅顯示將執行操作,不實際傳輸 | 安全預檢必用 | |
mirror --only-newer | 僅傳輸較新文件 (基於時間戳) | 增量備份核心參數 | |
mirror --continue | 斷點續傳 (需遠端伺服器支援 REST/APPE) | 大文件/弱網必備 | |
mirror --delete | 刪除目標端源端不存在的文件 (雙向同步慎用!) | 保持目標端與源端完全一致 | |
| 文件上傳/下載 | put | 上傳單個文件 | put local.file put -o remote.name local.file (重命名) |
mput | 上傳多個文件 (支援通配符) | mput *.tar.gz mput -c *.iso (續傳) | |
get | 下載單個文件 | get remote.file get -o local.name remote.file | |
mget | 下載多個文件 | mget *.log mget -c large.iso | |
pget | **多線程下載單個大文件** (分段並行,極大提速) | pget -n 10 bigfile.iso (10 線程) | |
| 目錄導航與操作 | cd / lcd | 切換遠端/本地目錄 | cd /remote/path lcd ~/local/path |
ls / lls | 列出遠端/本地目錄內容 | ls -lh lls -la | |
mkdir / lmkdir | 創建遠端/本地目錄 | mkdir -p remote/dir | |
rm / mrm / rmdir | 刪除遠端文件/多文件/目錄 | mrm *.tmp rmdir old_dir | |
| 隊列與任務控制 | queue | 將命令加入隊列順序執行 (後台批量處理) | queue get bigfile1.iso queue get bigfile2.iso queue start |
jobs / jobctl | 查看/控制作業 (停止、刪除、優先級) | jobs -v jobctl --stop 1 | |
wait | 等待所有隊列任務完成 | 腳本末尾確保完成 | |
bg / fg | 後台/前台運行當前命令 | 交互模式下 Ctrl+Z 暫停後 bg 後台續傳 | |
| 搜索與過濾 | glob | 按模式列出文件 (不遞歸) | glob *.log glob -r *.conf (遞歸) |
find | 遞歸搜索文件 (支援 -name, -size, -time 等) | find -name "*.iso" -size +1G | |
grep | 在文件中搜索文本 (需下載後本地 grep) | 通常配合 get 使用 | |
| 書籤與會話 | bookmark add name | 保存當前連接為書籤 | bookmark add myserver 後可 lftp myserver 快速連接 |
bookmark list / edit / del | 管理書籤 | ||
set bmk:save-passwords yes | 保存密碼至書籤 (慎用,明文存儲 ~/.local/share/lftp/bookmarks) | ||
| 設置與調試 | set | 查看/修改設置 (大量選項,見下文) | set net:max-retries 3 set xfer:clobber on |
debug | 開啟調試輸出 (級別 0-9) | debug 3 看協議交互 | |
help [cmd] | 查看幫助 | help mirror |
在 ~/.lftp/rc 或交互模式 set 配置持久化:
# 連接優化
set net:max-retries 3 # 重試次數
set net:reconnect-interval-base 5
set net:reconnect-interval-multiplier 1
set net:timeout 30 # 連接/數據超時
set net:connection-limit 4 # 單主機最大並行連接數 (mirror --parallel 受此限制)
# 傳輸優化
set xfer:clobber on # 允許覆蓋本地同名文件
set xfer:use-temp-file on # 先下載到 .lftp.tmp 再重命名 (原子性、避免部分文件)
set xfer:verify-command "sha256sum" # 下載後校驗 (需服務端支援 SHA256)
set xfer:rate-limit 0 # 總帶寬限制 (0 無限制,單位 Bytes/s)
# FTP/FTPS 特有
set ftp:passive-mode on # 被動模式 (穿透 NAT/防火牆必開)
set ftp:ssl-force on # 強制 FTPS (隱式/顯式)
set ftp:ssl-protect-data on # 加密數據通道
set ftp:ssl-allow on # 允許 SSL (自動協商)
# SFTP 特有
set sftp:auto-confirm yes # 自動接受主機金鑰 (已知主機慎用)
set sftp:connect-program "ssh -a -x -o BatchMode=yes" # 自定義 SSH 參數
# 通用
set cmd:save-rl-history on # 保存命令歷史
set color:use-color true # 彩色輸出
lftp -c "
open -u deploy_user,'StrongPass!' ftp://deploy.server.com
lcd /home/deploy/project/build
cd /var/www/html
mirror -R -v --parallel=10 \
--exclude-glob .git/ \
--exclude-glob var/cache/ \
--exclude-glob *.log \
--exclude-glob .env \
--delete-first \
. .
bye
"
lftp -c "
open -u backup_user,'PassW0rd' sftp://backup.server.com
cd /remote/backups/prod
lcd /mnt/backup/prod
mirror -v --parallel=5 \
--only-newer \
--continue \
--exclude-glob *.tmp \
--exclude-glob *.partial \
.
bye
"
# 校驗關鍵文件
lftp -c "open sftp://backup.server.com; get -v backup_20240101.tar.gz.sha256; bye"
sha256sum -c backup_20240101.tar.gz.sha256
# 交互模式
lftp -u user,pass ftp://files.example.com
cd /iso
pget -n 16 ubuntu-22.04.3-server-amd64.iso # 16 線程下載
# 或腳本模式
lftp -c "open -u user,pass ftp://files.example.com; pget -n 16 /iso/ubuntu-22.04.3-server-amd64.iso -o /data/iso/; bye"
#!/bin/bash
# sync_backup.sh
set -euo pipefail
LOG="/var/log/lftp_sync_$(date +%F).log"
LFTP_CMD="
open -u $FTP_USER,'$FTP_PASS' ftp://$FTP_HOST
lcd $LOCAL_DIR
cd $REMOTE_DIR
mirror -R -v --parallel=5 --only-newer --continue --delete-first \
--exclude-glob .git/ --exclude-glob *.log . .
bye
"
echo "=== $(date) Start sync ===" >> $LOG
if lftp -c "$LFTP_CMD" >> $LOG 2>&1; then
echo "=== $(date) Sync SUCCESS ===" >> $LOG
# 發送成功通知 (Email/企業微信/DingTalk/Slack Webhook)
else
echo "=== $(date) Sync FAILED ===" >> $LOG
# 發送告警通知
exit 1
fi
| 問題 | 原因與解決 |
|---|---|
| 連接超時/拒絕 | 防火牆阻擋端口 (21, 990, 22, 數據端口範圍)、IP 白名單、FTP 被動模式端口範圍未在防火牆開放 (vsftpd/proftpd pasv_min/max_port、防火牆放行該範圍)。 |
| FTPS 證書驗證失敗 | set ssl:verify-certificate no (測試環境) 或導入 CA 證書 set ssl:ca-file /path/ca.pem。 |
| 鏡像同步刪除錯誤文件 | mirror --delete 危險!必須先 --dry-run 預演,確認刪除列表無誤再執行。生產環境建議**不使用 --delete**,改用版本化備份/對象存儲生命週期策略。 |
| 中文文件名亂碼 | 設置編碼:set ftp:charset "utf-8" (FTP)、set sftp:charset "utf-8" (SFTP)。服務端也需支援 UTF-8。 |
| 大文件傳輸中斷無法續傳 | 確認伺服器支援 REST (下載斷點) 和 APPE (上傳斷點)。使用 get -c / put -c / mirror --continue。SFTP 原生支援續傳。 |
| 腳本中密碼明文不安全 | 1. 使用 .netrc 文件 (chmod 600) 存儲憑證,lftp 自動讀取。2. 使用 SSH Key 認證 SFTP (免密最安全)。 3. 環境變數傳遞 (CI/CD 密鑰管理)。 4. 期待 lftp 支援密碼管理器整合。 |
lftp 是 Linux 下**功能最全、自動化程度最高**的文件傳輸工具。掌握 mirror (鏡像同步)、pget (多線程下載)、queue (任務隊列)、腳本化與設置優化 核心技能,即可高效完成:網站部署發布、異地災備同步、大數據集下載、跨協議文件遷移、定時自動化備份 等核心運維任務。生產環境務必重視 **安全認證 (SSH Key/FTPS)、帶寬控制、錯誤處理、日誌審計、預演驗證 (--dry-run)**,確保數據傳輸可靠、可控、可追溯。