C# FTP 操作完整指南：FtpWebRequest 上傳下載、目錄管理與協議限制

核心認知：FTP 協議不支援「遠端修改檔案」

FTP 命令集無「編輯檔案」指令。所謂修改 = 下載 → 本地修改 → 上傳覆蓋。

.NET 核心類：FtpWebRequest / FtpWebResponse

var req = (FtpWebRequest)WebRequest.Create("ftp://host/path/file.txt");
req.Credentials = new NetworkCredential("user", "pass");
req.Method = WebRequestMethods.Ftp.UploadFile; // 或 DownloadFile, ListDirectory, MakeDirectory

using (var fs = File.OpenRead(localPath))
using (var rs = req.GetRequestStream())
    fs.CopyTo(rs);

using (var resp = (FtpWebResponse)req.GetResponse())
    Console.WriteLine($"Status: {resp.StatusDescription}");

常用 Method 列舉

• UploadFile、DownloadFile、DeleteFile、Rename
• ListDirectory、ListDirectoryDetails（含權限/大小/時間）
• MakeDirectory、RemoveDirectory
• GetFileSize、GetDateTimestamp

實戰注意點

1. 被動模式：預設啟用，防火牆/NAT 友好。主動模式需 req.UsePassive = false 並開放數據端口。
2. 二進制/ASCII：req.UseBinary = true（預設）傳圖片/壓縮包；文本檔可設 false 自動換行轉換。
3. SSL/TLS：req.EnableSsl = true 需伺服器支援 FTPS（隱式/顯式）。
4. 大檔案斷點續傳：FTP 支援 REST 命令，需手動設定 req.ContentOffset。
5. 異步：.NET 4.5+ 使用 GetRequestStreamAsync/GetResponseAsync 避免阻塞 UI。

using var conn = new AsyncFtpClient("host", "user", "pass");
await conn.Connect();
await conn.UploadFile(localPath, "/remote/path");