rz (Receive ZModem)、**sz (Send ZModem)** 是基於 **ZModem 協議** 的終端機檔案傳輸工具組 (lrzsz 套件)。它們讓你在 SSH/終端機會話中,**無需開啟 SFTP/SCP 客戶端**,直接透過終端機通道上傳/下載檔案。
| 發行版 | 指令 |
|---|---|
| RHEL/CentOS/Fedora/Rocky/Alma | yum install lrzsz / dnf install lrzsz |
| Debian/Ubuntu/Mint | apt install lrzsz |
| Arch/Manjaro | pacman -S lrzsz |
| openSUSE | zypper install lrzsz |
| Alpine | apk add lrzsz |
| 操作 | 指令 | 流程 |
|---|---|---|
| 下載 (伺服器 → 本地) | sz filenamesz file1 file2 dir/ | 1. 伺服器發送 ZModem 封包 2. 終端機 (SecureCRT/Xshell/Tabby 等) 攔截並彈出「另存為」對話框 3. 確認路徑 → 接收完成 |
| 上傳 (本地 → 伺服器) | rzrz -be (二進位+逸出) | 1. 伺服器發送 ZModem 接收請求 2. 終端機彈出「選擇檔案」對話框 3. 選檔確認 → 上傳至伺服器**當前目錄** 4. 檔案擁有者為**當前登入用戶** |
Options → Session Options → Terminal → Xmodem/Zmodem → Directories
sz 接收檔案的預設資料夾rz 發送檔案的預設資料夾右鍵分頁 → 屬性 → ZMODEM → 接收資料夾 / 發送資料夾
~/Downloads 或可在設定中指定Settings → Configuration → Zmodem**不支援 ZModem 圖形化攔截**。需搭配 lrzsz 的 zssh 或使用 scp/sftp 替代。
cd /tmprz (等待接收)cd /path/to/filessz firmware.bin| 參數 | 作用 | 常用組合 |
|---|---|---|
-b | 二進位模式 (預設文字模式會轉換換行符) | rz -be / sz -b |
-e | 逸出控制字元 (解決 0x10/0x02 等衝突) | rz -be / sz -be |
-y | 覆寫既有檔案不詢問 | rz -bey |
-q | 安靜模式 (減少進度顯示) | sz -q largefile.iso |
-E | 發送端:強制發送檔案結束標記 | 解決某些終端機掛住問題 |
| 現象 | 原因 | 解決方案 |
|---|---|---|
| 執行 rz/sz 無反應、卡住 | 終端機未支援/未啟用 ZModem 攔截 | 確認終端機設定啟用 ZModem、嘗試 rz -bey、改用 scp/sftp |
| 上傳檔案損壞/大小不對 | 未使用二進位模式 (-b) | **永遠加 -b 參數**:rz -be, sz -be |
| 中文檔名亂碼 | 終端機編碼與伺服器 locale 不一致 | 統一 UTF-8:export LANG=zh_TW.UTF-8,終端機設定 UTF-8 |
| 大檔傳輸極慢/中斷 | ZModem 經由終端機通道轉發,受限於 SSH 緩衝與終端機實作 | 大檔 (>100MB) **強烈建議改用 scp/rsync/sftp** |
| 權限拒絕 | 當前目錄無寫入權限 | cd /tmp 或有權限目錄再執行 rz |
| 場景 | 推薦工具 | 理由 |
|---|---|---|
| 單一小檔 (<50MB)、已在 SSH 會話中 | rz/sz | 無需開新連線、圖形化選檔、最便捷 |
| 大檔、多檔、目錄、斷點續傳 | rsync -avzP / scp -r | 高效、可靠、支援壓縮/增量/權限保留 |
| 自動化腳本、CI/CD、非互動 | scp/rsync/sftp 批次模式 | rz/sz 需人工互動,不適合自動化 |
| 圖形化管理、資料夾同步 | FileZilla / WinSCP / MobaXterm SFTP 面板 | 視覺化操作、拖拉上傳、書籤管理 |
| 嵌入式/無 IP 直連串口 | rz/sz (minicom/picocom) | 串口唯一選項,ZModem 具錯誤修正/重傳 |
alias rz='echo "rz disabled, use scp"' 或移除 lrzsz 套件rz/sz 是 **SSH 會話中快速傳輸小檔案的利器**,核心口訣:安裝 lrzsz、終端機啟用 ZModem、設定預設目錄、大檔改用 rsync、生產環境禁用 rz。嵌入式開發、網路設備維護、跳板機操作場景尤為實用。