你可能早就用過rz也見過它在終端里打印出rz waiting to receive.***B0100000023be50這樣的握手信息。但很多人第一次用它時都會有同一個困惑文件明明顯示上傳成功去服務(wù)器目錄里卻找不到不知道它到底傳到哪去了。要回答這個問題需要把rz的協(xié)議原理、依賴環(huán)境、工作目錄規(guī)則和常見報錯串成一條鏈路來理解。這篇內(nèi)容會從 Zmodem 協(xié)議講起給出 lrzsz 的安裝方法、常用參數(shù)、最小實操、完整校驗流程再落到排查步驟和生產(chǎn)選型建議上。1. 先理解rz命令Zmodem 協(xié)議與文件傳輸場景1.1 rz 和 sz一對基于 Zmodem 的上傳下載命令rz并不是一個獨立的軟件它來自lrzsz軟件包。這個軟件包提供了兩個核心命令rz接收文件對應(yīng)英文 Receive。sz發(fā)送文件對應(yīng)英文 Send。這里的“接收”和“發(fā)送”要站在服務(wù)器視角來理解。你在本地終端里通過 SSH 登錄到遠端 Linux 服務(wù)器然后在服務(wù)器上執(zhí)行rz表示服務(wù)器準備接收來自本地終端的文件。終端軟件看到 Zmodem 握手后會彈出本地文件選擇窗口你選中文件后文件就從本地機器傳到服務(wù)器。反過來你在服務(wù)器上執(zhí)行sz 文件名終端會彈出另存為窗口把服務(wù)器文件下載到本地。二者都基于 Zmodem 協(xié)議。Zmodem 是早期調(diào)制解調(diào)器時代誕生的文件傳輸協(xié)議支持錯誤檢測、斷點續(xù)傳和批量文件傳輸。SSH 時代并不直接需要它來做加密因為文件內(nèi)容是走 SSH 會話通道傳輸?shù)慕K端軟件只是把 Zmodem 的控制序列嵌入到終端輸出里再由本地端響應(yīng)。也就是說整個鏈路可以寫作本地終端Xshell/SecureCRT 等 | | SSH Zmodem 控制序列 v 遠端 Linux 服務(wù)器lrzsz 提供 rz/sz 命令這個模型解釋了為什么rz的使用不像scp那么“純命令式”它依賴本地終端軟件配合而不是只靠一條命令完成全部操作。1.2 rz 解決什么場景不解決什么場景rz最合適的場景是臨時上傳幾個小文件。你正在終端里處理配置、排查問題突然需要把一個.sql腳本或.tar.gz包傳到服務(wù)器又不愿意切換到 SFTP 客戶端這時rz是最順手的選擇。它不需要額外開通端口不需要記住遠端路徑文件會直接落到你當前所在的目錄。但rz不適合以下場景上傳大量目錄結(jié)構(gòu)比如整個前端構(gòu)建產(chǎn)物幾百個文件分布在多個子目錄里。無人值守的腳本任務(wù)rz依賴交互式終端和本地文件選擇窗口腳本里執(zhí)行很容易卡住。對可審計性、可回滾要求嚴格的發(fā)布流程生產(chǎn)環(huán)境不建議依賴終端軟件的人工選擇。理解這一點很重要。rz本質(zhì)上是給人用的交互式工具不是給腳本用的自動化接口。2. 環(huán)境準備安裝 lrzsz 并確認終端支持 Zmodem 協(xié)議2.1 lrzsz 軟件包的安裝方法絕大多數(shù) Linux 發(fā)行版都可以通過包管理器安裝lrzsz。Debian/Ubuntu 系統(tǒng)使用 aptsudo apt update sudo apt install lrzsz -yCentOS/RHEL 7 或 8 使用 yumsudo yum install lrzsz -yCentOS/RHEL 9、Rocky Linux、Fedora 等使用 dnfsudo dnf install lrzsz -y安裝完成后先驗證命令是否存在which rz which sz rz --version sz --version正常輸出里會包含類似rz (lrzsz) 0.12.20的版本信息。如果執(zhí)行rz提示command not found不要急著懷疑命令不存在先確認是不是漏裝了軟件包。2.2 終端對 Zmodem 的支持程度這是最容易踩坑的一步。遠端服務(wù)器安裝了 lrzsz只意味著服務(wù)器端有了 Zmodem 接收能力本地終端還必須能識別 Zmodem 控制序列并把文件選擇窗口彈出來整個流程才能跑通。不同終端軟件的支持情況差異很大可以參考下表終端軟件是否原生支持 Zmodem實際使用說明Xshell支持連接屬性里可以配置上傳下載的默認本地目錄SecureCRT支持Zmodem 集成比較成熟使用穩(wěn)定FinalShell支持同時提供圖形化文件管理但 rz 也可用MobaXterm支持不同版本實現(xiàn)有差異遇到問題先確認版本PuTTY原生不支持默認不能彈出 Zmodem 文件選擇框Windows Terminal WSL原生不支持直接執(zhí)行 rz 會卡在 waiting 狀態(tài)如果你使用 Window 系統(tǒng)推薦先用 Xshell、SecureCRT 或 FinalShell 這類帶 Zmodem 支持的客戶端。這樣在學(xué)習(xí)階段可以減少終端層面的干擾把注意力放在命令本身。2.3 安裝完成后如何驗證在服務(wù)器執(zhí)行cd /tmp rz如果本地終端彈出文件選擇窗口說明 Zmodem 鏈路正常。如果窗口沒有彈出終端一直停留在rz waiting to receive狀態(tài)就需要回到本地終端的 Zmodem 配置上去排查而不是繼續(xù)在服務(wù)器端調(diào)試。3.rz命令常用參數(shù)和交互行為詳解3.1 基礎(chǔ)命令格式和啟動流程rz的基礎(chǔ)用法非常簡單rz執(zhí)行后終端輸出rz waiting to receive.***B0100000023be50這行輸出不是錯誤而是 Zmodem 接收方的握手提示。支持 Zmodem 的終端會攔截這串序列并彈出本地文件選擇框選完文件后開始傳輸。如果這不是你要的效果檢查本地終端是否真正支持 Zmodem而不是糾結(jié)為什么這里沒有文件路徑。3.2 常用參數(shù)速查表rz的參數(shù)不算多但每個參數(shù)的選擇會影響文件完整性和使用體驗。常用參數(shù)如下參數(shù)作用使用建議-y自動覆蓋同名文件常用但生產(chǎn)環(huán)境要確認不會覆蓋重要文件-b二進制傳輸模式推薦用于壓縮包、可執(zhí)行文件、庫文件-aASCII 傳輸模式適合純文本可能轉(zhuǎn)換換行符-e對所有控制字符轉(zhuǎn)義和-b搭配使用更穩(wěn)定-E遇到重名文件時自動跳過或重命名不同版本語義有差異落地前要實測-q安靜模式日志輸出場景可用-v詳細模式排錯時使用參數(shù)組合時可以直接連寫比如rz -be rz -by rz -ey這里要特別注意不同版本的 lrzsz 對某些參數(shù)的處理略有差異尤其是-E。你不需要死記所有參數(shù)把它當成一個備查表即可等真正遇到問題再回來查。3.3 rz -y 的覆蓋機制rz -y的-y表示在遇到同名文件時直接覆蓋不再等待用戶確認。這個參數(shù)能加快操作但后果是原文件被替換后沒有自動恢復(fù)機制。很多人因為習(xí)慣性輸入rz -y上傳時不小心覆蓋了服務(wù)器上的同名文件等到發(fā)現(xiàn)時已經(jīng)找不到原始內(nèi)容了。建議的做法是上傳前在目標目錄執(zhí)行l(wèi)s -l先確認同名文件情況。重要目錄不要直接傳先傳到臨時目錄再移動覆蓋。如果必須覆蓋上傳完整后立刻做一次校驗而不是等到業(yè)務(wù)報錯才發(fā)現(xiàn)。3.4 -a、-b、-e 的選擇邏輯-a是 ASCII 模式傳輸純文本時會把換行符轉(zhuǎn)換成適合目標系統(tǒng)的格式。Windows 和 Linux 的換行符不同-a會做自動轉(zhuǎn)換所以文本文件在-a模式下通常更友好。-b是二進制模式不做任何轉(zhuǎn)換字節(jié)原樣傳輸。對.tar.gz、.zip、.jar、.so、數(shù)據(jù)庫備份文件一定使用-b否則二進制內(nèi)容可能被換行符轉(zhuǎn)換破壞傳上去的文件打不開。-e是對控制字符做轉(zhuǎn)義降低終端把文件內(nèi)容誤認為控制序列的風(fēng)險。實際項目中如果你不確定文件類型或者要傳輸比較大、比較復(fù)雜的文件直接用rz -be這樣既保證二進制原樣傳輸又減少控制字符干擾比裸rz更穩(wěn)妥。不過也要說明-e會略微增加傳輸數(shù)據(jù)量但在現(xiàn)代網(wǎng)絡(luò)環(huán)境下這點開銷通?？梢院雎浴?. 最小實操用rz上傳文件并校驗完整流程4.1 準備目標目錄和文件在服務(wù)器上創(chuàng)建一個專門用于上傳的目錄并進入目錄mkdir -p /tmp/upload cd /tmp/upload pwd這一步的目的是讓上傳行為可控。如果你一登錄就執(zhí)行rz文件會落到用戶主目錄時間久了目錄會變得雜亂。先在臨時目錄里操作至少能確認文件被傳到了哪里。4.2 執(zhí)行 rz 并選擇文件在/tmp/upload目錄下執(zhí)行rz -be本地終端彈出文件選擇窗口后選擇需要上傳的文件比如app.tar.gz。等待終端提示傳輸完成。如果本地文件比較大傳輸過程可能會持續(xù)一段時間不要中途關(guān)閉終端窗口。如果你確定目標目錄沒有同名文件或者希望直接覆蓋舊文件可以使用rz -be -y4.3 用命令驗證上傳結(jié)果傳輸完成后不要只看“成功”提示要用命令確認落盤文件和文件完整性。先查看文件是否存在ls -l /tmp/upload再用file命令判斷文件類型file /tmp/upload/app.tar.gz最后計算校驗值md5sum /tmp/upload/app.tar.gz在本地機器上執(zhí)行對應(yīng)的 md5 計算對比兩邊的摘要值。如果一致說明文件確實完整傳輸網(wǎng)絡(luò)或終端沒有引入損壞。校驗這一步是排查問題的關(guān)鍵技巧之后遇到rz傳完打不開的文件第一個反應(yīng)就應(yīng)該是對比哈希值。5. “上傳的文件去哪了”工作目錄、查找方法和落盤驗證5.1 當前工作目錄決定落盤位置這是搜索熱度非常高的問題rz上傳的文件在哪。答案很簡單rz把文件保存到執(zhí)行命令時所在的當前工作目錄而不是某個固定目錄也不保留本地文件路徑信息。你本地文件在D:\project\config\application.yml傳到服務(wù)器后它會變成服務(wù)器當前目錄下的application.yml而不是自動創(chuàng)建config子目錄。這個行為對很多人來說是反直覺的但它就是 Zmodem 接收器的默認工作方式。驗證方式pwd rz你在哪個目錄執(zhí)行rz文件就在哪個目錄。終端提示上傳成功后立刻用ls -lt | head查看最近修改的文件一般都能找到。5.2 文件找不到時從哪個路徑查當你上傳后找不到文件按下面的順序排查執(zhí)行pwd查看當前工作目錄。如果剛登錄服務(wù)器沒有執(zhí)行過cd文件一般在用戶主目錄下root 用戶是/root普通用戶是/home/用戶名。檢查是否在多個終端窗口里執(zhí)行過命令會不會上傳到了另一個窗口對應(yīng)的會話目錄。查找最近 10 分鐘內(nèi)修改過的文件find ~ -maxdepth 3 -mmin -10 -type f -exec ls -lh {} \;這條命令會列出用戶主目錄三層以內(nèi)最近 10 分鐘生成的文件通常能快速定位剛上傳的文件。5.3 重名文件的后綴行為不帶-y參數(shù)時如果目標目錄已經(jīng)存在同名文件rz會詢問怎么處理有的版本會生成類似file.0、file_1的重名文件有的版本會提示選擇“覆蓋”或“跳過”。這個行為受終端和 lrzsz 版本雙重影響不統(tǒng)一也不要在腳本里依賴它。更可靠的做法是在上傳前主動控制目錄狀態(tài)清空臨時目錄或者把同名文件先改名。這樣無論參數(shù)行為如何你都能預(yù)判文件最終叫什么。6. 常見失敗現(xiàn)象、原因與排查路徑6.1 命令不存在現(xiàn)象-bash: rz: command not found原因服務(wù)器沒有安裝 lrzsz 軟件包。處理按第 2 節(jié)安裝對應(yīng)發(fā)行版的包安裝后重新執(zhí)行rz --version驗證。6.2 終端卡在 waiting 狀態(tài)現(xiàn)象rz waiting to receive.***B0100000023be50然后一直沒有任何反應(yīng)本地也不彈文件選擇窗口。原因本地終端不支持 Zmodem或者終端的 Zmodem 功能被禁用了。檢查方式確認使用的終端軟件是否支持 ZmodemPuTTY 和 Windows Terminal 原生不支持。查看 Xshell、SecureCRT 的連接屬性或文件傳輸配置看 Zmodem 相關(guān)選項是否被關(guān)閉。處理方式更換支持 Zmodem 的終端或者放棄rz改用scp。6.3 庫文件、大文件傳輸失敗或中斷現(xiàn)象上傳.so庫文件、幾十 MB 以上的安裝包時傳輸中途卡住或者傳完后文件無法使用終端提示傳輸失敗。原因使用了 ASCII 傳輸模式二進制內(nèi)容被換行符轉(zhuǎn)換破壞。本地終端對 Zmodem 大文件的緩沖和超時設(shè)置不合適。網(wǎng)絡(luò)不穩(wěn)定Zmodem 重傳超時后客戶端沒有正確處理。服務(wù)器磁盤空間不足或 inode 耗盡。檢查方式df -h df -i處理方式使用rz -be重試。大文件先壓縮再傳或者拆分成多個分片。生產(chǎn)環(huán)境直接使用scp或rsync不要依賴終端 Zmodem 傳輸大文件。6.4 上傳后文件為空或亂碼現(xiàn)象文件傳上去了也有正確文件名但打開內(nèi)容是亂碼或者file命令識別不出類型。原因rz使用了-aASCII 模式把二進制文件里的部分字節(jié)轉(zhuǎn)換掉了。Windows 和 Linux 的 CRLF 換行差異是常見觸發(fā)因素。處理刪除服務(wù)器上的文件使用rz -b重新上傳然后對比兩端md5sum。6.5 權(quán)限不足導(dǎo)致的寫入失敗現(xiàn)象上傳時提示 permission denied或者傳輸結(jié)束后目標位置沒有出現(xiàn)文件。原因當前用戶沒有目標目錄的寫權(quán)限。檢查方式ls -ld /tmp/upload處理方式切換到有權(quán)限的目錄或者調(diào)整目錄權(quán)限。如果你使用 sudo 執(zhí)行rz要注意 sudo 會把當前工作目錄帶到 root 環(huán)境實際落盤位置可能變成/root。更好的寫法是sudo bash -c cd /目標目錄 rz這樣可以保證文件進入預(yù)期目錄同時以 root 權(quán)限完成寫入。6.6 排查順序清單遇到rz相關(guān)問題時建議按這個順序排查確認rz命令是否存在。確認終端是否支持 Zmodem。確認pwd明確當前工作目錄。確認目標目錄有寫權(quán)限。確認文件沒有損壞使用file和md5sum。檢查磁盤空間、網(wǎng)絡(luò)穩(wěn)定性、終端傳輸配置。如果問題依舊換scp或rsync先保證業(yè)務(wù)能繼續(xù)。7. 什么時候不該用rz選型對比和生產(chǎn)建議7.1 rz/sz 與 scp、sftp、rsync 的對比工具交互性適合場景主要限制rz/sz交互式小文件臨時上傳下載依賴終端支持難以自動化scp命令式單文件、多文件直接傳輸不支持增量同步和斷點續(xù)傳sftp交互式/命令式文件管理、上傳下載比 rz 通用適合腳本集成rsync命令式大量文件、目錄同步上手成本略高但適合生產(chǎn)rz的優(yōu)勢是方便劣勢則是自動化能力弱。你在終端里操作時它很好用但一旦要放到 CI/CD 流水線、定時任務(wù)或無人值守腳本里rz就基本不適合了。7.2 生產(chǎn)環(huán)境的上傳推薦生產(chǎn)環(huán)境上傳文件時優(yōu)先考慮以下方式一次性發(fā)布包使用scp上傳例如scp app.tar.gz userserver:/data/release/。大量文件同步使用rsync -avz --progress --partial支持斷點續(xù)傳和增量同步。需要批量交互使用sftp腳本可用-b參數(shù)指定命令文件。涉及對象存儲或云環(huán)境使用云廠商 CLI 工具把文件先傳到 OSS/S3再從服務(wù)器端拉取。這些方式比rz更適合記錄日志、控制權(quán)限和接入流水線。學(xué)習(xí)rz的目的是理解它在方便場景下的價值而不是把它當成生產(chǎn)環(huán)境的萬能上傳工具。7.3 自動化腳本中的 rz 注意事項不要在無人值守腳本里直接執(zhí)行rz。rz依賴交互式 TTY 和本地終端的 Zmodem 支持腳本環(huán)境下它通?？ㄔ趙aiting to receive直到超時既不完成傳輸也不退出。如果腳本確實需要從本地傳輸文件到服務(wù)器改寫為scp或rsync更可靠。例如scp -i ~/.ssh/id_rsa app.tar.gz deploytarget:/opt/app/如果用rsyncrsync -avz --partial app.tar.gz deploytarget:/opt/app/這樣的命令可記錄、可重試、可監(jiān)控也方便接入日志系統(tǒng)。7.4 安全審計和文件完整性建議即使你選擇使用rz也要注意幾點不要讓用戶直接在業(yè)務(wù)目錄執(zhí)行rz最好先上傳到專用臨時目錄比如/tmp/upload確認文件名和校驗值后再移動到目標位置。上傳后執(zhí)行sha256sum或md5sum與本地比對避免只憑“傳輸成功”提示做判斷。對上傳目錄的權(quán)限進行控制避免所有用戶都能寫入尤其是 web 服務(wù)可讀寫目錄防止文件被替換。不要把rz包裝成無人值守服務(wù)來使用它本來就是終端交互工具不適合作為系統(tǒng)級上傳通道。8. 擴展閱讀從rz延伸到常用 Linux 命令的學(xué)習(xí)方法rz只是眾多 Linux 命令中的一條但它能反映出一個學(xué)習(xí)思路一條命令不是一個孤立的單詞而是由協(xié)議、依賴、參數(shù)、目錄規(guī)則和替代方案組成的一整條鏈路。學(xué)習(xí)rz時你會接觸到 lrzsz 軟件包、Zmodem 協(xié)議、終端支持程度、pwd目錄定位、md5sum校驗、scp/rsync文件傳輸對比這些知識在運維和日常開發(fā)中都會反復(fù)使用。如果你打算繼續(xù)深入可以按下面路徑練習(xí)在測試服務(wù)器上執(zhí)行rz -be和rz --help把參數(shù)表過一遍。上傳一個文本文件和一個二進制文件分別觀察-a與-b的區(qū)別。用md5sum和file驗證上傳結(jié)果。用scp和rsync完成同樣的文件傳輸對比使用體驗。把兩條命令放進腳本確認rz在非交互環(huán)境下確實不適用而scp和rsync可以穩(wěn)定運行。對初學(xué)者來說最重要的不是背下所有選項而是養(yǎng)成“命令執(zhí)行后如何驗證”的習(xí)慣。以后無論使用rz、scp還是rsync都會先考慮文件最終落在哪、權(quán)限是否正確、內(nèi)容有沒有損壞、日志能不能追蹤到。這就是比記住一條命令更有價值的工程能力。