簡介PCMans FTP Server 是一款面向初學(xué)者的開源輕量級 FTP 服務(wù)端軟件目標(biāo)是讓不熟悉網(wǎng)絡(luò)配置的使用者也能快速完成基本服務(wù)器的搭建設(shè)計上以簡單易用為先功能與安全性并非重點適合剛接觸 FTP 協(xié)議、希望了解服務(wù)端工作原理的入門者與自學(xué)者。壓縮包共 143 個文件、約 154KB主體是 VC 工程源碼34 個 cpp 與 39 個 h 文件構(gòu)成服務(wù)端核心邏輯涉及命令解析、用戶管理與主框架界面43 個 ini 及 rc、bmp、ico 等資源文件承載界面配置與圖標(biāo)位圖另有 dsp、dsw、clw 等工程與類向?qū)募芍苯佑?Visual C 打開編譯。該資源已有 204 人學(xué)習(xí)下載讀者可由此獲得一套可運(yùn)行的 FTP 服務(wù)端完整實現(xiàn)對照源碼理解連接建立、命令響應(yīng)與用戶權(quán)限控制的處理流程也可在其基礎(chǔ)上裁剪擴(kuò)展作為課程設(shè)計、協(xié)議學(xué)習(xí)與 MFC 界面實踐的參考樣本。1. PCMans FTP Server一個不用安裝的開源 FTP 服務(wù)端能解決什么某次在內(nèi)網(wǎng)給幾臺設(shè)備刷升級包手邊只有一臺 Windows 機(jī)器沒有外網(wǎng)也不允許裝需要授權(quán)的服務(wù)端。先試的是系統(tǒng)自帶的 FTP 角色角色裝上、站點建好、授權(quán)配完客戶端連上去還是一句 530。最后救場的是一份一百多 KB 的開源軟件——PCMans FTP Server解壓雙擊就能當(dāng)服務(wù)端使。這類開源軟件在 Windows 上不算多見不寫注冊表、不裝運(yùn)行庫、不駐留后臺服務(wù)從老版本 Windows 到現(xiàn)在的桌面版和服務(wù)器版都能開起來。裝順了它就是一臺隨身的文件交換站裝不順時現(xiàn)象也很集中——能登錄卻列不出目錄、大文件傳一半斷掉、中文名全變問號。它適合內(nèi)網(wǎng)分發(fā)、設(shè)備取包、臨時給同事傳大文件這類活要域名、虛擬主機(jī)、強(qiáng)制加密那一套的它接不住。裝之前先想清楚一件事這東西小但小不等于沒有前置條件。端口、防火墻、被動模式端口段、NTFS 權(quán)限缺一個就是半小時的排查。2. 裝前清單Windows 版本、21 端口與被動端口段怎么定很多人拿到這個 exe 的第一反應(yīng)是雙擊、建賬號、發(fā)地址然后在客戶端那邊卡住回頭懷疑軟件有問題。實際上絕大多數(shù)「連不上」都不是軟件的問題而是裝之前沒把三件事定下來跑在哪個系統(tǒng)上、用哪個端口、數(shù)據(jù)目錄給誰讀寫。這一章把這三件事按順序捋一遍后面的步驟才好往下走。2.1 運(yùn)行環(huán)境它到底依賴哪些東西它是原生的 Win32 程序這一點很關(guān)鍵。不需要 .NET Framework不需要 VC 運(yùn)行庫不需要 Java也不需要先裝什么「服務(wù)端框架」。這也是它在老機(jī)器、封閉內(nèi)網(wǎng)、臨時救急場景里特別順手的原因——拷過去就能開不用先聯(lián)網(wǎng)下一堆依賴。程序本身是 32 位的在 64 位系統(tǒng)上照樣跑不會有什么兼容層的問題。系統(tǒng)覆蓋范圍從 Windows XP SP3 一直到現(xiàn)在的桌面版和服務(wù)器版都能用。硬件要求基本可以忽略幾十 MB 內(nèi)存、幾百 KB 磁盤就能撐住十幾個人的小流量。網(wǎng)上流傳最廣的版本是 2.0.7這個項目本身早就停止更新了所以不必去追什么「最新版」——它沒有活躍的迭代分支你看到的各種版本號差別往往只是漢化包和打包方式不同。項目要求說明操作系統(tǒng)Windows XP SP3 及以上桌面版、服務(wù)器版均可32/64 位系統(tǒng)都行運(yùn)行庫無不需要 .NET、VC、Java磁盤占用幾百 KB程序本體極小空間主要留給數(shù)據(jù)目錄內(nèi)存占用幾十 MB 量級隨并發(fā)連接數(shù)增長個人用途壓力很小權(quán)限普通用戶可運(yùn)行只有加防火墻規(guī)則、注冊服務(wù)需要管理員網(wǎng)絡(luò)一個固定內(nèi)網(wǎng) IP建議手工配靜態(tài)地址別用自動獲取需要提醒的是老程序在新系統(tǒng)上的顯示問題高 DPI 屏幕上界面可能發(fā)虛窗口不會自動縮放。這不影響功能別把它當(dāng)成裝壞了。2.2 端口規(guī)劃21、被動端口段和防火墻規(guī)則FTP 跟普通 Web 服務(wù)最大的區(qū)別是它用兩條連接一條控制連接走命令和返回碼一條數(shù)據(jù)連接專門搬文件。數(shù)據(jù)連接有兩種建立方式主動模式下由服務(wù)端回頭連客戶端被動模式下由服務(wù)端開一個端口等客戶端來連。前者在客戶端位于 NAT 后面時基本必掛所以真正要配的是被動模式也就是常說的 PASV 端口段?？刂贫丝谀J(rèn) 21。Windows 并不限制普通用戶綁定 1024 以下的端口所以哪怕不用管理員身份也能綁上 21但如果這臺機(jī)器上還跑著別的 FTP 組件21 會被占那就換 2121 之類的端口客戶端連的時候顯式指定即可。被動端口段別劃太大十個就夠十幾個人用劃成 50000-50009 這種連續(xù)區(qū)間最省事防火墻規(guī)則也好寫。# 管理員身份執(zhí)行放行控制端口和被動數(shù)據(jù)端口段 netsh advfirewall firewall add rule namePCManFTP-Ctrl dirin actionallow protocolTCP localport21 netsh advfirewall firewall add rule namePCManFTP-PASV dirin actionallow protocolTCP localport50000-50009 # 確認(rèn)端口已經(jīng)被監(jiān)聽第二列是本地地址最后一列是進(jìn)程 PID netstat -ano | findstr :21第一條規(guī)則管登錄和命令交互第二條管文件傳輸。dirin表示入站方向actionallow是放行l(wèi)ocalport可以直接寫區(qū)間這是 netsh 比較省事的地方不用一條一條加。規(guī)則名自己起起完以后用netsh advfirewall firewall show rule namePCManFTP-PASV能回查刪的時候按名字刪別去翻圖形界面找。netstat那條是裝完必跑的確認(rèn)動作。如果 21 端口沒有出現(xiàn)在 LISTENING 狀態(tài)說明服務(wù)端根本沒起來或者綁到了別的地址上這時候去查防火墻是白費(fèi)功夫。真遇到端口被占用用netstat -ano | findstr :21拿到最后一列的 PID再tasklist | findstr PID就知道是哪個進(jìn)程搶的。提示不要為了「排除問題」直接把防火墻整個關(guān)掉。關(guān)掉只能證明問題出在防火墻上證明不了是哪個端口排查完還得一條條加回來來回折騰。2.3 目錄與身份別用管理員賬號跑服務(wù)數(shù)據(jù)目錄的選擇比想象中重要。我一般單獨(dú)劃一個目錄比如D:\ftp下面分root對外可見的根和upload收文件的地方。三個地方堅決不放用戶目錄下的 Desktop 和 Downloads因為權(quán)限繼承混亂、清理時容易誤刪網(wǎng)盤同步目錄同步客戶端會持續(xù)占用文件句柄FTP 寫入時報共享沖突屬于典型的玄學(xué)問題以及含中文或空格的路徑老程序?qū)捵址窂降奶幚聿⒉粐?yán)謹(jǐn)這是踩過坑之后定下來的規(guī)矩。身份也要單獨(dú)給。不要用 Administrator 或者當(dāng)前登錄的管理員賬號跑服務(wù)一旦目錄權(quán)限配錯等于把整臺機(jī)器的寫權(quán)限開放出去了。建一個專用本地賬號只對這個數(shù)據(jù)目錄有修改權(quán)限其他盤一概不給。建目錄和授權(quán)兩條命令就能搞定。# 建一個只碰 FTP 數(shù)據(jù)目錄的本地賬號 $p ConvertTo-SecureString ChangeThis_2024! -AsPlainText -Force New-LocalUser -Name ftpsvc -Password $p -PasswordNeverExpires -Description FTP data account New-Item -ItemType Directory -Force -Path D:\ftp\root,D:\ftp\upload | Out-Null # (OI) 對象繼承、(CI) 容器繼承、M 修改權(quán)限、/T 遞歸到子目錄 icacls D:\ftp /grant ftpsvc:(OI)(CI)M /TPasswordNeverExpires這一項別省。服務(wù)化之后如果這個賬號的密碼到期服務(wù)會靜默啟動失敗表現(xiàn)出來就是「昨天還好好的今天連不上」而且日志里什么都不會寫非常難查。icacls里的(OI)和(CI)是讓權(quán)限往下繼承不加這兩個參數(shù)只對當(dāng)前目錄生效子目錄里的文件照樣寫不進(jìn)去。給M修改而不是F完全控制是因為完全控制里包含改權(quán)限的能力沒必要給。3. 從解壓到第一個賬號PCMans FTP Server 的落地步驟環(huán)境定完就可以動手了。這一章的節(jié)奏是先把文件放對地方再啟動看界面然后建第一個能登錄的賬號最后處理「重啟之后它不自己起來」這個必然會遇到的問題。每一步都有可以回退的檢查點別一口氣全做完再測。3.1 落地目錄程序和數(shù)據(jù)分開放下載下來一般是個壓縮包解開之后是主程序和可能附帶的語言文件、說明文檔。把整個文件夾一起搬到D:\apps\pcmanftp不要只挑那個 exe 拷出來——有些打包版本帶語言文件缺了會變成英文界面功能不受影響但配置項看著費(fèi)勁。程序目錄定下來之后就別再挪了。這類綠色程序的配置通常跟著程序目錄走賬號的主目錄路徑、端口、限速這些設(shè)置都存在旁邊路徑一變之前配的賬號主目錄很可能全部失效表現(xiàn)是登錄成功但目錄是空的。這也是我建議一開始就用固定路徑的原因別圖省事放在桌面臨時跑一下。另外不要放在C:\Program Files底下。那個目錄受 UAC 保護(hù)程序?qū)懪渲玫臅r候會被重定向或者直接失敗表現(xiàn)是「設(shè)置改完重啟就還原」很容易誤判成軟件 bug。3.2 首次啟動托盤圖標(biāo)、主窗口和日志窗雙擊主程序任務(wù)欄右下角會出現(xiàn)一個托盤圖標(biāo)雙擊它才彈出主窗口。界面上大致分三塊賬號管理、目錄或虛擬目錄設(shè)置、以及一個滾動的日志窗。第一次啟動時默認(rèn)沒有任何正式賬號匿名訪問可能是開著的也可能是關(guān)著的取決于打包版本的默認(rèn)配置所以第一步先去看賬號列表別急著發(fā)地址給同事。日志窗是這個軟件最有價值的排錯入口比任何第三方抓包工具都直接?？蛻舳诉B上來之后它會把收到的命令和服務(wù)端返回的碼逐行打出來USER、PASS、PWD、PASV、LIST、RETR哪一步斷的一目了然。養(yǎng)成習(xí)慣——客戶端報錯的第一時間不是去改配置而是先看日志窗停在哪一行。如果雙擊之后托盤沒有圖標(biāo)先懷疑端口占用。有些機(jī)器上裝過別的 FTP 組件21 被占了程序啟動時綁定失敗但界面不一定彈提示。這時候用 2.2 節(jié)那條netstat查一下或者干脆先把控制端口改成 2121 試一次能起來就說明是端口沖突。3.3 建第一個賬號主目錄、權(quán)限位和密碼建賬號這一步建議保守一點第一次只開讀權(quán)限確認(rèn)能登錄能列目錄能下載再把寫權(quán)限加上去。一次性把權(quán)限全打開出了問題分不清是認(rèn)證的問題還是權(quán)限的問題。參數(shù)建議值原因用戶名純英文加數(shù)字中文和空格在部分老客戶端上會解析出錯密碼12 位以上混合字符這類輕量服務(wù)端沒有防暴力破解機(jī)制主目錄D:\ftp\root或每人一個子目錄多人的時候分目錄刪庫不至于全沒初始權(quán)限只勾讀取和列目錄先驗證通路再逐步放開匿名訪問默認(rèn)關(guān)閉內(nèi)網(wǎng)也不建議長期開著密碼這件事值得單獨(dú)說一句。很多人裝完隨手設(shè)個ftp或者123456覺得反正是內(nèi)網(wǎng)。但內(nèi)網(wǎng)里通常還掛著打印機(jī)、攝像頭、各種默認(rèn)口令的設(shè)備一臺機(jī)器被當(dāng)成跳板之后第一個被掃的就是這種無防護(hù)的 FTP。設(shè)一個正經(jīng)密碼成本幾乎為零。建完之后立刻用客戶端連一次別等到配完限速、虛擬目錄、服務(wù)化之后再測。一次只改一個變量出問題才知道是哪個改動引起的。3.4 無人值守把它注冊成 Windows 服務(wù)托盤程序的固有問題注銷之后進(jìn)程跟著會話結(jié)束機(jī)器重啟后不會自動起來遠(yuǎn)程桌面斷開連接時間長了也可能被回收。放在自己電腦上臨時用無所謂放在一臺專門的文件交換機(jī)上就必須解決。常見做法是用 nssm 這類服務(wù)包裝器把托盤程序包成一個標(biāo)準(zhǔn)的 Windows 服務(wù)。# 把主程序注冊成服務(wù)指定工作目錄設(shè)置自動啟動和異常重啟 nssm install PCManFTP D:\apps\pcmanftp\PCManFTPd.exe nssm set PCManFTP AppDirectory D:\apps\pcmanftp nssm set PCManFTP Start SERVICE_AUTO_START nssm set PCManFTP AppExit Default Restart nssm set PCManFTP ObjectName .\ftpsvc ChangeThis_2024! nssm start PCManFTPAppDirectory必須設(shè)因為程序會去當(dāng)前工作目錄找配置文件不設(shè)的話服務(wù)起來讀的是C:\Windows\System32配置全是空的表現(xiàn)就是「服務(wù)在跑但賬號全沒了」。AppExit Default Restart讓它在異常退出時自動拉起對付偶發(fā)的崩潰有用。ObjectName指定用剛才建的那個低權(quán)限賬號跑服務(wù)不要用 LocalSystem理由和 2.3 節(jié)一樣。注意服務(wù)化之后托盤圖標(biāo)不再出現(xiàn)界面里改的配置有可能不落到服務(wù)實例上或者被服務(wù)重啟覆蓋。正確順序是先在界面里把賬號、端口、限速全部調(diào)好、測通最后再注冊服務(wù)之后所有改動走配置文件不要再依賴界面。4. 配置逐項摳權(quán)限位、虛擬目錄、限速與中文編碼到這一步服務(wù)已經(jīng)能跑、賬號已經(jīng)能登剩下的就是把參數(shù)調(diào)到一個長期不惹事的狀態(tài)。這一章的四組配置項前兩組決定「誰能干什么」后兩組決定「出事的時候損失多大」。每一項都說清楚為什么這么設(shè)方便你按自己的場景改。4.1 六個權(quán)限位勾選之前先想清楚誰在用賬號的權(quán)限是一組復(fù)選框看著簡單但組合出來的效果差別很大。核心是區(qū)分「發(fā)文件」和「收文件」兩類場景不要一律全勾。權(quán)限位作用什么場景給列表/瀏覽能看見目錄里有什么幾乎所有場景都要給不給就是登錄成功但一片空白讀取/下載能把文件取走分發(fā)升級包、共享資料時給寫入/上傳能往目錄里放新文件收包場景給注意不能覆蓋同名文件追加能在已有文件末尾續(xù)寫斷點續(xù)傳需要風(fēng)險是磁盤被慢慢撐滿刪除能刪文件只給維護(hù)賬號普通收發(fā)賬號不給重命名能改文件名同上改名的破壞力常被低估三個典型組合可以直接抄只發(fā)不收的賬號給「列表 讀取」客戶端只能下載不能動手只收不發(fā)的賬號給「列表 寫入 建目錄」不給刪除和重命名這樣對方傳錯了你還能救回來雙向交換的賬號才全開但同時要配上磁盤配額或者在目錄所在分區(qū)留足余量。追加權(quán)限單獨(dú)提一下它是斷點續(xù)傳的前提但也是唯一一個能讓單個文件無限增長的權(quán)限。如果開給了外部設(shè)備最好在數(shù)據(jù)目錄上掛一個磁盤配額或者用計劃任務(wù)定期清理超期文件。4.2 虛擬目錄把三塊盤拼成一棵樹一個賬號只有一個主目錄這是硬限制。虛擬目錄解決的就是這個把別的物理路徑掛成主目錄下的一個名字客戶端看到的是一個連續(xù)的目錄樹實際文件散落在不同磁盤上。最典型的用法是主目錄放只讀的發(fā)布包D:\ftp\root上傳目錄單獨(dú)放一塊大容量盤E:\incoming掛成root/upload?？蛻舳说卿浿罂吹降木褪且粋€目錄不用關(guān)心后面是幾塊盤。另一個好處是不暴露真實盤符結(jié)構(gòu)少一點信息泄露。掛載的時候有兩個坑。一是掛載點名字不要和主目錄里已有的真實子目錄重名沖突時的行為不好預(yù)期有的版本會讓真實目錄直接不可見。二是虛擬目錄如果指向 UNC 路徑\\某主機(jī)\共享名而服務(wù)是用本地賬號跑的會因為拿不到網(wǎng)絡(luò)憑據(jù)而訪問失敗日志里表現(xiàn)為列目錄超時或者 550。這種場景要么把服務(wù)登錄賬戶換成有共享權(quán)限的賬號要么先把共享映射成本地盤再掛。4.3 限速、連接數(shù)與超時小機(jī)器的自保參數(shù)這組參數(shù)平時沒存在感出問題的時候就是整臺機(jī)器被拖死。估算方法很簡單先看上行帶寬再除以單個人愿意接受的傳輸速度。10 Mbps 上行、單人給 2 Mbps那就是五個人同時傳設(shè)成 8 留點余量。最大連接數(shù)按上面的估算填別拍腦袋填 100。超出的連接會被拒客戶端表現(xiàn)是「有時候能連有時候不能」。單 IP 連接數(shù)建議 2 到 3。多線程下載工具默認(rèn)會開五到十條連接不限的話一個人就能把隊列占滿。上傳/下載限速單位通常是 KB/s填的時候注意別把 KB 當(dāng) Kb差八倍?？臻e超時60 到 300 秒之間。太短會把正在思考人生的客戶端踢掉太長會讓半死的連接一直占著名額。還有一個容易忽略的聯(lián)動被動端口段的大小必須大于等于最大連接數(shù)。只劃了 5 個端口卻允許 20 個連接同時傳文件的時候就會有一部分人連不上數(shù)據(jù)連接現(xiàn)象是能登錄、能列目錄、下載卡住不動。這個坑非常隱蔽因為控制連接一切正常。4.4 中文亂碼GBK 還是 UTF-8亂碼是這個軟件被抱怨最多的地方但根源不在軟件在 FTP 協(xié)議本身。控制連接默認(rèn)沒有規(guī)定字符編碼各家客戶端各按各的理解來Windows 資源管理器按系統(tǒng)本地編碼簡體中文環(huán)境是 GBK解釋很多第三方客戶端默認(rèn)按 UTF-8 解釋。同一個目錄換個客戶端打開就是一堆問號。服務(wù)端如果提供編碼選項優(yōu)先選 UTF-8這是現(xiàn)在的主流。但如果客戶端里有老設(shè)備——嵌入式系統(tǒng)、老版本的系統(tǒng)自帶客戶端——它們只會按本地編碼走那就只能退回 GBK兩邊不能同時滿足。折中做法是干脆繞開這個問題目錄名和文件名全部用英文數(shù)字加下劃線中文只出現(xiàn)在文件內(nèi)容里。我現(xiàn)在所有 FTP 目錄都是這個規(guī)矩省下來的排查時間遠(yuǎn)比改名的麻煩多。真要用中文名就固定一種客戶端別今天用資源管理器明天用別的工具然后懷疑服務(wù)端壞了。5. 踩坑排查能登錄卻列不出目錄的五個原因下面五條是這套環(huán)境里出現(xiàn)頻率最高的故障按「現(xiàn)象、原因、解決」寫遇到問題時按順序?qū)μ柸胱?。每一條都對應(yīng)前面某一節(jié)的配置項回頭改就行。5.1 能登錄、目錄列不出來現(xiàn)象客戶端提示登錄成功命令行里敲ls卡十幾秒最后報數(shù)據(jù)連接建立失敗圖形客戶端表現(xiàn)為一直轉(zhuǎn)圈然后空白。原因九成是被動模式端口段沒有放行?？刂七B接走的是 21通的數(shù)據(jù)連接要連 50000 段被防火墻攔了。剩下的一成是服務(wù)端返回的 PASV 地址是內(nèi)網(wǎng) IP而客戶端在另一個網(wǎng)段連過去自然不通。解決先按 2.2 節(jié)把 PASV 段加到防火墻規(guī)則里重試。還不行就判斷是不是跨網(wǎng)段把客戶端放到同一網(wǎng)段測一次通就說明是地址回填的問題服務(wù)端有對外 IP 填寫項就填上沒有就只能在同網(wǎng)段使用或者做端口映射時把 PASV 段一起映射。5.2 輸入賬號密碼一直 530現(xiàn)象用戶名密碼明明是對的返回 530 登錄失敗。原因按可能性排序——賬號沒有啟用很多版本新建賬號默認(rèn)是停用狀態(tài)賬號的主目錄路徑寫錯了或者目錄被刪了路徑不存在時認(rèn)證階段就會被拒密碼里帶了特殊字符在某些配置文件里被截斷連接數(shù)達(dá)到上限新連接直接被拒。解決先看日志窗服務(wù)端到底收到了什么用戶名如果連USER都沒打印出來問題在客戶端打印了但緊跟著 530就去核對主目錄是否存在。密碼先用純字母數(shù)字試一次能進(jìn)就說明是特殊字符的問題換掉即可。5.3 傳大文件傳一半就斷現(xiàn)象幾十 MB 的包傳到六成左右斷掉重傳又從零開始。原因空閑超時設(shè)得太短傳輸過程中控制連接長時間沒有命令往來被判定空閑磁盤空間不足殺毒軟件的實時掃描鎖住了正在寫入的文件網(wǎng)絡(luò)本身抖動。解決先把超時調(diào)到 300 秒再試這是最常見的一條。然后看數(shù)據(jù)目錄所在分區(qū)的剩余空間。還斷就把數(shù)據(jù)目錄從實時掃描的范圍里排除這條要按自己環(huán)境的策略評估別一刀切。最后才懷疑網(wǎng)絡(luò)方法是同一臺機(jī)器本地回環(huán)測一次本地不斷說明是鏈路問題。5.4 中文文件名變成問號現(xiàn)象用系統(tǒng)資源管理器打開中文目錄全是問號換成別的客戶端又正常。原因控制連接的編碼不一致一端按 GBK 發(fā)一端按 UTF-8 解。這不是權(quán)限問題也不是文件系統(tǒng)問題改權(quán)限改目錄都無效。解決統(tǒng)一編碼服務(wù)端和客戶端選同一種。做不到統(tǒng)一就把文件名改成英文見 4.4 節(jié)。別在這上面反復(fù)重裝軟件重裝一百次結(jié)果一樣。5.5 重啟之后服務(wù)沒自己起來現(xiàn)象手動雙擊能用機(jī)器一重啟就連不上登錄機(jī)器一看托盤圖標(biāo)也沒有。原因托盤程序本來就不是服務(wù)開機(jī)自啟項有時也不生效已經(jīng)服務(wù)化的常見是服務(wù)賬戶密碼到期、或者賬戶沒有「作為服務(wù)登錄」的權(quán)限服務(wù)啟動失敗但系統(tǒng)不彈提示。解決用 3.4 節(jié)的方式注冊服務(wù)賬戶密碼設(shè)成永不過期給 nssm 配上輸出重定向把標(biāo)準(zhǔn)輸出和錯誤寫到文件里服務(wù)起不來的時候那個文件里會有直接原因比翻系統(tǒng)日志快得多。6. 裝完怎么驗三條命令、一張對照表和我的收尾習(xí)慣裝完不等于裝好。我的標(biāo)準(zhǔn)是換一臺機(jī)器、用另一種客戶端、走一遍完整的上傳下載、校驗哈希一致這才算交付。下面這套冒煙流程十分鐘能走完但能擋掉后面八成的問題。6.1 三條命令走完一輪冒煙第一條驗登錄和列目錄重點是把被動模式開關(guān)各試一次。同一條命令UsePassive設(shè) true 通、設(shè) false 不通基本可以確定是 NAT 或防火墻方向的問題而不是賬號問題。# 冒煙一登錄并列出根目錄true 走 PASVfalse 走 PORT各跑一次對比 $cred New-Object System.Net.NetworkCredential(ftpuser,YourPass123) $req [System.Net.FtpWebRequest]::Create(ftp://192.168.1.20/) $req.Method [System.Net.WebRequestMethodsFtp]::ListDirectory $req.Credentials $cred $req.UsePassive $true # 關(guān)鍵變量換成 false 再跑一次 $req.Timeout 10000 # 控制連接超時單位毫秒 $resp $req.GetResponse() (New-Object System.IO.StreamReader($resp.GetResponseStream())).ReadToEnd() $resp.Close()第二條驗寫權(quán)限和磁盤空間傳一個幾十 MB 的文件別用小文件小文件測不出超時和限速的問題。# 冒煙二上傳一個真實大小的文件 $up [System.Net.FtpWebRequest]::Create(ftp://192.168.1.20/upload/test.bin) $up.Method [System.Net.WebRequestMethodsFtp]::UploadFile $up.Credentials $cred $up.UseBinary $true # 必須開否則換行符會被轉(zhuǎn)換哈希對不上 $up.UsePassive $true $bytes [System.IO.File]::ReadAllBytes(D:\tmp\test.bin) $s $up.GetRequestStream() $s.Write($bytes, 0, $bytes.Length) $s.Close() $up.GetResponse().Close()UseBinary這一項千萬別漏。文本模式下客戶端會做換行符轉(zhuǎn)換傳上去的文件大小和哈希都會變?nèi)缓竽銜詾槭莻鬏攭牧似鋵嵤悄Ｊ竭x錯了。第三條是哈希比對兩端各算一次值一樣才算真正傳對了。# 冒煙三服務(wù)端和客戶端各跑一次比對 SHA256 certutil -hashfile D:\ftp\upload\test.bin SHA256 certutil -hashfile D:\tmp\test.bin SHA2566.2 一張驗收對照表檢查項動作期望結(jié)果端口監(jiān)聽netstat -ano | findstr :21狀態(tài)為 LISTENINGPID 是主程序被動端口客戶端強(qiáng)制 PASV 傳輸數(shù)據(jù)連接建立成功無超時登錄認(rèn)證錯誤密碼試一次返回 530日志窗有記錄讀權(quán)限下載一個文件并比對哈希哈希一致寫權(quán)限上傳一個文件目錄中出現(xiàn)且大小一致權(quán)限邊界用只讀賬號嘗試上傳被拒絕返回 550 類錯誤中文名建一個中文名目錄再訪問客戶端顯示正常或按約定全英文重啟演練重啟機(jī)器后直接連接無需人工干預(yù)即可登錄倒數(shù)第二行那個「權(quán)限邊界」最容易被跳過。只測了「能做的都能做」沒測「不能做的確實做不了」等于權(quán)限配置根本沒驗證過。用一個只讀賬號去傳一次被明確拒絕才說明權(quán)限位生效了。6.3 我的收尾習(xí)慣從那以后我每次交付這類環(huán)境都要強(qiáng)制走一遍「換機(jī)驗證 重啟演練」。換機(jī)驗證是拿一臺沒參與過配置的機(jī)器當(dāng)客戶端避免把配置機(jī)的緩存和環(huán)境變量當(dāng)成理所應(yīng)當(dāng)重啟演練是直接重啟一次服務(wù)器不做任何人工操作就看能不能連上——服務(wù)化配得對不對只有這一步能驗出來。另外兩個小習(xí)慣一是把日志窗的輸出定期留檔出問題的時候能倒推出是哪天哪個 IP 傳了什么二是數(shù)據(jù)目錄所在分區(qū)的剩余空間掛個提醒FTP 這種長期無人看守的服務(wù)最后出問題十有八九是磁盤滿了而不是軟件壞了。這套東西不復(fù)雜把該配的配到位、該驗的驗一遍剩下的就是讓它安靜地跑著。希望幫到你。本文還有配套的精品資源點擊獲取