C#中如何实现文件上传到FTP服务器

Chihiro863

于 2025-06-19 11:16:32 发布

阅读量958

点赞数 14

CC 4.0 BY-SA版权

文章标签： c# 服务器开发语言

本文链接：https://blog.youkuaiyun.com/2403_88955316/article/details/148762015

好的，我们来详细解释一下FTP的原理和在C#中如何实现文件上传到FTP服务器。这对于工作应用非常实用。

一、 FTP 上传/下载文件的基本原理

FTP (File Transfer Protocol) 是一种专门用于在客户端和服务器之间高效传输文件的标准网络协议。它的工作原理有几个关键点：

双通道模型：
- 控制连接 (Control Connection)： 通常使用 TCP 端口 21。这个连接一直保持打开，用于在客户端和服务器之间发送命令和响应。例如，客户端发送 USER username, PASS password, CWD directory, STOR filename (上传), RETR filename (下载) 等命令；服务器返回状态码（如 200 OK, 150 File status okay; about to open data connection, 226 Transfer complete）和消息。
- 数据连接 (Data Connection)： 用于实际传输文件内容或目录列表。这个连接是临时的，在需要传输数据时建立，传输完成后关闭。
建立连接的步骤：
- 客户端通过服务器的IP地址或域名以及端口号（默认21）发起一个TCP连接到服务器的控制端口。
- 客户端发送登录凭证（用户名/密码）进行身份验证。
- 客户端通过控制连接发送命令（如 CWD 切换目录，TYPE I 设置二进制模式）。
- 当需要进行文件传输（上传/下载）或列出目录时，客户端和服务器协商建立数据连接。
数据连接的建立模式 (关键！)：
- 主动模式 (Active Mode - PORT 命令)：
  - 客户端在控制连接上告诉服务器：“我将在 IP=X.X.X.X 的 端口 Y 上监听数据连接”。
  - 服务器主动从它的数据端口（通常是 20） 连接到客户端指定的 IP 和端口 (Y)。
  - 问题： 如果客户端位于防火墙或NAT（路由器）后面，防火墙/NAT通常会阻止外部发起的连接，导致数据连接失败。这是主动模式的主要缺点。
- 被动模式 (Passive Mode - PASV 命令 - 推荐)：
  - 客户端在控制连接上发送 PASV 命令。
  - 服务器响应：“好的，请在 IP=A.B.C.D 的 端口 P 上连接我”。（服务器会随机打开一个高端口 P 等待连接）。
  - 客户端主动从它自己的一个随机端口连接到服务器指定的 IP (A.B.C.D) 和端口 (P)。
  - 优势： 由于连接是客户端发起的，更容易穿透客户端的防火墙/NAT。这是现代应用（尤其是客户端在内部网络时）最常用的模式。
文件传输过程：
- 上传 (Upload - STOR 命令)：
  1. 客户端通过控制连接发送 STOR filename 命令（例如 STOR myfile.zip）。
  2. 根据模式（主动/被动）建立数据连接。
  3. 客户端通过数据连接读取本地文件并发送文件内容字节流到服务器。
  4. 服务器通过数据连接接收字节流并将其写入指定的文件名。
  5. 数据传输完成，数据连接关闭。
  6. 服务器通过控制连接发送传输结果（如 226 Transfer complete）。
- 下载 (Download - RETR 命令)：
  1. 客户端通过控制连接发送 RETR filename 命令。
  2. 根据模式（主动/被动）建立数据连接。
  3. 服务器通过数据连接读取请求的文件并发送文件内容字节流到客户端。
  4. 客户端通过数据连接接收字节流并将其写入本地文件。
  5. 数据传输完成，数据连接关闭。
  6. 服务器通过控制连接发送传输结果。
传输模式：
- ASCII 模式 (TYPE A): 用于传输纯文本文件。FTP 会尝试在传输过程中转换行结束符（如 \r\n <-> \n）。传输二进制文件（如图片、压缩包、可执行文件）会导致文件损坏。
- 二进制/图像模式 (TYPE I - 推荐)： 原样传输文件字节，不做任何转换。这是传输任何非纯文本文件（以及安全传输所有文件）的必需模式。 在C#中，我们几乎总是使用这个模式。

二、在 C# 中实现上传文件到 FTP 服务器

.NET Framework 提供了 System.Net.FtpWebRequest 类来简化 FTP 操作。以下是如何使用它上传文件：

核心步骤

创建请求对象 (FtpWebRequest): 使用 WebRequest.Create 并转换为 FtpWebRequest。
设置凭据 (Credentials): 提供 FTP 服务器的用户名和密码。
设置方法 (Method): 设置为 WebRequestMethods.Ftp.UploadFile。
设置必要属性:
- UsePassive = true: (强烈推荐) 使用被动模式，避免防火墙问题。
- UseBinary = true: (强烈推荐) 使用二进制模式传输，确保文件完整性。
- KeepAlive = false: 传输完成后关闭连接（通常需要）。
(可选) 读取本地文件内容: 将你要上传的文件读入一个字节数组 (byte[]) 或流 (FileStream)。
获取请求流 (GetRequestStream): 调用此方法获取一个用于写入上传数据的流。
写入文件内容: 将本地文件的内容（字节数组或文件流）写入到上一步获取的请求流中。
关闭请求流: 确保关闭流以发送数据。
获取响应 (GetResponse): 调用此方法触发实际的上传操作并获取服务器的响应 (FtpWebResponse)。
检查响应状态 (StatusDescription): 查看服务器返回的状态信息（通常是 "226 Transfer complete" 表示成功）。
关闭响应 (Close): 关闭响应对象。

示例代码 (基础上传)

using System;
using System.IO;
using System.Net;
using System.Text;

public class FtpUploader
{
    public static void UploadFile(string localFilePath, string ftpServerUrl, string ftpUsername, string ftpPassword)
    {
        try
        {
            // 1. 创建 FtpWebRequest 对象
            FtpWebRequest request = (FtpWebRequest)WebRequest.Create(ftpServerUrl);
            request.Method = WebRequestMethods.Ftp.UploadFile;

            // 2. 设置凭据
            request.Credentials = new NetworkCredential(ftpUsername, ftpPassword);

            // 3. 设置关键属性 (推荐被动模式和二进制模式)
            request.UsePassive = true; // 重要！避免防火墙问题
            request.UseBinary = true;  // 重要！传输二进制文件
            request.KeepAlive = false; // 传输完成后关闭连接

            // 4. 读取本地文件内容到字节数组 (适合中小文件)
            byte[] fileContents;
            using (FileStream sourceStream = new FileStream(localFilePath, FileMode.Open))
            {
                fileContents = new byte[sourceStream.Length];
                sourceStream.Read(fileContents, 0, fileContents.Length);
            }

            // 5. 获取请求流并写入数据
            using (Stream requestStream = request.GetRequestStream())
            {
                requestStream.Write(fileContents, 0, fileContents.Length);
            } // using 块会自动关闭 requestStream

            // 6. 获取服务器响应
            using (FtpWebResponse response = (FtpWebResponse)request.GetResponse())
            {
                Console.WriteLine($"上传状态: {response.StatusCode} - {response.StatusDescription}");
            } // using 块会自动关闭 response
        }
        catch (WebException ex)
        {
            // 处理网络或FTP协议错误
            FtpWebResponse response = ex.Response as FtpWebResponse;
            if (response != null)
            {
                Console.WriteLine($"FTP 错误: {response.StatusCode} - {response.StatusDescription}");
                response.Close();
            }
            else
            {
                Console.WriteLine($"网络错误: {ex.Message}");
            }
        }
        catch (Exception ex)
        {
            // 处理其他异常（如文件IO错误）
            Console.WriteLine($"错误: {ex.Message}");
        }
    }
}

// 使用方法
string localFile = @"C:\MyFiles\report.pdf";
string ftpUrl = "ftp://ftp.yourserver.com/path/to/remote/folder/report.pdf"; // 包含目标文件名
string username = "your_ftp_username";
string password = "your_ftp_password";

FtpUploader.UploadFile(localFile, ftpUrl, username, password);

改进点 (重要！)

流式传输 (大文件必备)： 上面例子将整个文件读入内存 (byte[])，对于大文件会消耗大量内存甚至崩溃。改用流式传输：

// ... (前面的设置代码相同) ...
request.Method = WebRequestMethods.Ftp.UploadFile;

// 使用文件流直接写入请求流
using (FileStream sourceStream = new FileStream(localFilePath, FileMode.Open))
using (Stream requestStream = request.GetRequestStream())
{
    byte[] buffer = new byte[1024 * 1024]; // 1MB 缓冲区 (可调整)
    int bytesRead;
    while ((bytesRead = sourceStream.Read(buffer, 0, buffer.Length)) > 0)
    {
        requestStream.Write(buffer, 0, bytesRead);
    }
} // 两个流都会自动关闭

// ... (获取响应和错误处理代码相同) ...

目录处理： ftpUrl 必须包含完整的远程路径和文件名。如果需要确保目录存在，可能需要先发送 MKD/CWD 命令（使用 WebRequestMethods.Ftp.MakeDirectory 和 WebRequestMethods.Ftp.ListDirectory 等方法检查/创建目录）。
进度报告： 在流式传输的循环中，可以计算已传输字节数 (totalBytesRead += bytesRead) 和文件总大小 (sourceStream.Length)，计算百分比并更新UI或日志。

超时设置 (Timeout, ReadWriteTimeout): 网络环境差时可适当增加超时时间（毫秒）。

request.Timeout = 300000; // 5分钟连接超时
request.ReadWriteTimeout = 300000; // 5分钟读写超时

安全性：
- FTP 本身不安全： 用户名、密码和文件内容都是明文传输！切勿用于敏感数据。
- 替代方案： 如果服务器支持，强烈建议使用 SFTP (SSH File Transfer Protocol) 或 FTPS (FTP over SSL/TLS)。它们在传输层加密数据。
- C# 实现 SFTP： 需要使用第三方库，如 SSH.NET (非常流行且免费)。基本用法类似，但使用 SftpClient 和 Sftp.UploadFile/DownloadFile 方法。
- C# 实现 FTPS： FtpWebRequest 可以通过设置 EnableSsl = true 来尝试使用隐式 FTPS（端口通常是990）。显式 FTPS (在端口21上使用 AUTH TLS/AUTH SSL) 的兼容性可能需要额外配置或使用更高级的库（如 FluentFTP）。
使用更强大的库 (推荐)： 对于更复杂或生产级的应用，FtpWebRequest 有时显得不够灵活或存在一些已知问题。强烈推荐使用开源库 FluentFTP。它：
- 提供更简洁、流畅的API。
- 更稳健地处理各种FTP服务器和模式（主动/被动，ASCII/二进制）。
- 内置目录递归上传/下载、文件存在检查、权限设置、进度报告等功能。
- 更好地支持 FTPS 和代理。
- 社区活跃，文档完善。

三、在 C# 中实现从 FTP 服务器下载文件

原理类似，使用 WebRequestMethods.Ftp.DownloadFile 方法，并读取响应流 (GetResponseStream) 来保存文件：

public static void DownloadFile(string localFilePath, string ftpServerUrl, string ftpUsername, string ftpPassword)
{
    try
    {
        FtpWebRequest request = (FtpWebRequest)WebRequest.Create(ftpServerUrl);
        request.Method = WebRequestMethods.Ftp.DownloadFile;
        request.Credentials = new NetworkCredential(ftpUsername, ftpPassword);
        request.UsePassive = true;
        request.UseBinary = true;
        request.KeepAlive = false;

        using (FtpWebResponse response = (FtpWebResponse)request.GetResponse())
        using (Stream responseStream = response.GetResponseStream())
        using (FileStream fileStream = new FileStream(localFilePath, FileMode.Create))
        {
            byte[] buffer = new byte[1024 * 1024];
            int bytesRead;
            while ((bytesRead = responseStream.Read(buffer, 0, buffer.Length)) > 0)
            {
                fileStream.Write(buffer, 0, bytesRead);
            }
        }
        Console.WriteLine("下载完成！");
    }
    catch (Exception ex)
    {
        // ... 错误处理 (类似上传示例) ...
    }
}

总结

FTP 原理： 理解控制连接 (命令/响应) 和数据连接 (文件内容/目录列表) 的双通道模型，以及主动/被动模式的区别（务必使用被动模式）和传输模式（务必使用二进制模式）是基础。
C# 实现 (上传)： 使用 FtpWebRequest，设置 Method = WebRequestMethods.Ftp.UploadFile, Credentials, UsePassive = true, UseBinary = true。使用 GetRequestStream() 写入文件内容（推荐流式传输处理大文件），然后调用 GetResponse() 完成操作。做好错误处理和超时设置。
安全性警告： FTP 是明文协议。对于生产环境或敏感数据，优先使用 SFTP 或 FTPS。考虑使用 FluentFTP 库简化开发并增强功能。