拓冰网站定制 
简介PCMans FTP Server 是一款面向计算机初学者的开源 FTP 服务端软件主打「简单易用」帮助不熟悉网络配置的用户快速搭建基础 FTP 服务器无需深入理解协议细节即可完成文件共享。资源包共 143 个文件以 34 个 cpp 源文件、39 个 h 头文件为核心配合 43 个 ini 配置项、4 个 dsp 工程文件与 4 个 rc 资源脚本另有 ico、bmp 图标位图及 plg、aps 等辅助文件整体压缩后仅 154KB体积轻巧便于携带与二次编译。目前已有 202 人学习下载适合作为 C 网络编程入门、MFC 界面开发或小型 FTP 服务搭建的参考案例。通过阅读源码读者可了解 FTP 命令解析、用户管理、主框架与对话框交互等模块的组织方式并借助工程文件在旧版开发环境中直接编译运行快速理解一个轻量级服务端从界面到通信的完整实现思路。1. PCMans FTP Server一个被低估的轻量级开源方案如果你在 Windows 上折腾过 FTP 服务大概率经历过这样的场景FileZilla Server 装完发现配置项多到眼花Serv-U 功能全但要收费IIS 的 FTP 模块又跟系统绑得太死。这时候有人丢给你一个不到 200KB 的单文件程序双击就能跑配置文件是纯文本源码在 GitHub 上躺着——这就是 PCMans FTP Server一个用 Delphi 写的开源轻量级 FTP 服务端。它解决的核心问题很具体在 Windows 环境下快速搭一个能用的 FTP 服务不需要装运行时、不需要配数据库、不需要理解复杂的权限模型。适合谁嵌入式开发时给板子传固件、内网做文件分发、老设备维护时临时开个共享通道或者你就是想读一份结构清晰的 FTP 协议实现源码。开源意味着你能看到每一条命令怎么被解析、每一个响应码怎么被返回这对理解 FTP 协议本身比看 RFC 文档直观得多。2. 先搞清楚 FTP 协议的控制流与数据流为什么它比 HTTP 难伺候2.1 双连接模型21 端口只负责说话数据走另一条路FTP 跟 HTTP 最大的区别在于它用两条 TCP 连接。控制连接固定在 21 端口客户端登录、发命令、收响应码都走这条线数据连接是临时建立的传文件列表、传文件内容走这条线。这个设计在 1971 年很合理但在 NAT 和防火墙普及之后就成了万恶之源。PCMans FTP Server 的源码里控制连接的会话状态用TSession结构体维护每个客户端一个实例。数据连接有两种建立方式主动模式PORT下服务端从 20 端口主动连客户端被动模式PASV下服务端开一个随机端口等客户端来连。源码里TFTPServer类处理监听TSession处理命令解析两者通过回调函数通信。理解这个模型的意义在于你配置防火墙时不能只开 21 端口。主动模式要放行服务端出站的 20 端口被动模式要放行一个端口范围。很多“连上了但列不出目录”的问题根源都在这里。2.2 命令解析循环从 USER 到 QUIT 的完整链路PCMans FTP Server 的命令处理逻辑很直白核心是一个while循环读控制连接的缓冲区按空格切分命令和参数然后走case分支。下面是从源码结构里提炼出的伪代码逻辑帮你理解它怎么处理一条命令// 控制连接主循环基于源码逻辑重构 procedure TSession.Execute; var CmdLine: string; Cmd, Param: string; begin SendResponse(220 PCMan FTP Server ready); while not Terminated do begin CmdLine : ReadLineFromControlSocket; // 阻塞读超时 300 秒 SplitCommand(CmdLine, Cmd, Param); // 按第一个空格切分 Cmd : UpperCase(Cmd); if Cmd USER then SendResponse(331 Password required) else if Cmd PASS then begin if CheckAuth(Param) then SendResponse(230 Logged in) else SendResponse(530 Login incorrect); end else if Cmd PASV then EnterPassiveMode; // 开随机端口返回 227 响应 else if Cmd LIST then SendDirectoryList; // 通过数据连接发送 // ... 其余命令分支 end; end;这段逻辑说明几个关键点USER和PASS是分离的服务端在收到USER后返回 331 等待密码PASV命令触发被动模式服务端需要绑定一个新端口并告诉客户端LIST和RETR这类命令会触发数据连接的建立。参数说明方面ReadLineFromControlSocket的超时时间在源码里是硬编码的改大了会占资源改小了客户端容易断。2.3 主动模式与被动模式的选型判断什么时候用主动、什么时候用被动我的经验是客户端在 NAT 后面就用被动服务端在 NAT 后面就用主动。但现实情况往往是两边都在 NAT 后面这时候被动模式加端口映射是唯一出路。PCMans FTP Server 的被动模式实现里端口范围可以在配置文件里指定。常见做法是设一个窄范围比如 50000-50010然后在防火墙和路由器上把这个范围映射到服务端内网 IP。主动模式则要求服务端能出站连客户端的随机端口在云主机上基本不可用因为安全组默认不放行出站到高位端口。提示如果你在云主机上跑 PCMans FTP Server直接禁用主动模式只留被动模式能省掉一半的排错时间。3. 在 Windows 上把 PCMans FTP Server 跑起来从编译到第一个文件传输3.1 获取源码与编译环境准备PCMans FTP Server 是 Delphi 项目源码托管在 GitHub 上。你需要 Delphi 7 或更高版本才能编译Lazarus 也能凑合但可能需要改几处 Windows API 调用。如果不想装 Delphi直接下载作者预编译的 exe 也行但改配置和看源码是两回事。编译步骤大致如下# 1. 克隆仓库假设你已经装了 git git clone https://github.com/pcman-bbs/pcman-ftp-server.git # 2. 进入目录找到项目文件 cd pcman-ftp-server ls *.dpr # 应该能看到 PCManFTPServer.dpr # 3. 用 Delphi 命令行编译需要配置 dcc32 到 PATH dcc32 PCManFTPServer.dpr -E.\bin # 4. 编译产物在 bin 目录下 ls bin/如果你用 Lazarus打开.lpi文件后直接按 F9 编译。注意 Lazarus 下Windows单元的一些函数签名可能不同遇到Invalid floating point operation之类的报错检查SysUtils和Windows的引用顺序。3.2 配置文件逐项解读哪些参数必须改哪些可以不动PCMans FTP Server 的配置文件是纯文本通常叫ftpserver.ini或类似名字。下面是一个典型配置的逐项说明[Server] Port21 ; 控制端口改成 2121 可以避开 IIS 占用 MaxUsers10 ; 最大并发连接数按内存给每个会话约 1MB Timeout300 ; 控制连接空闲超时秒内网可以设 600 WelcomeMessageWelcome to PCMan FTP [Passive] PassivePortStart50000 ; 被动模式起始端口 PassivePortEnd50010 ; 被动模式结束端口范围别开太大 PassiveIP ; 留空则自动检测多网卡时手动填公网 IP [Users] ; 格式用户名密码:主目录:权限 adminsecret:C:\ftp\admin:RW guestguest:C:\ftp\public:R参数说明MaxUsers设太大没意义Windows 下每个连接占一个线程10 到 20 个并发对普通机械硬盘已经够呛。Timeout设太短会导致大文件传输中途断连设太长会积累僵尸会话。PassiveIP在多网卡机器上必须手动指定否则服务端返回的 IP 可能是内网地址客户端连不上。3.3 用命令行客户端验证服务是否正常服务跑起来之后别急着用 FileZilla 图形界面先用命令行验证能排除掉一半的客户端配置问题# 连接控制端口 ftp -p 127.0.0.1 2121 # 登录 Name: admin Password: secret # 查看当前目录 ftp ls # 切换被动模式命令行默认可能是主动 ftp passive # 下载一个测试文件 ftp get test.bin # 上传一个文件 ftp put upload.txt # 退出 ftp bye-p参数表示被动模式Windows 的 ftp 命令和 Linux 下行为略有不同。如果ls卡住不动多半是数据连接没建起来检查被动端口范围是否被防火墙拦了。如果登录就失败看服务端控制台有没有打印认证失败的日志。3.4 权限模型与目录隔离的实操PCMans FTP Server 的权限模型很简单每个用户绑定一个主目录权限只有读和写两个维度。没有虚拟目录、没有配额、没有 IP 白名单。这意味着你不能用它做多租户隔离但做单用户文件分发绰绰有余。配置多用户时每个用户在[Users]段占一行。主目录路径不要用中文和空格Delphi 的字符串处理在某些代码页下会出玄学问题。权限字段RW表示读写R表示只读W表示只写上传目录常用。如果你需要用户登录后直接进某个子目录把主目录指到那个子目录就行没有chroot的概念用户能通过cd ..逃逸——这是设计上的取舍不是 bug。4. 避坑与排查那些让你怀疑人生的连接问题4.1 现象客户端显示“已连接”但目录列表为空原因数据连接没有成功建立。主动模式下服务端连客户端的 20 端口被防火墙拦了被动模式下客户端连服务端的随机端口被拦了。解决先用ftp -p强制被动模式测试。如果被动模式正常说明主动模式出站被拦在服务端防火墙加一条出站规则放行 20 端口。如果被动模式也列不出目录检查PassivePortStart和PassivePortEnd之间的端口是否在防火墙入站规则里放行。Windows 防火墙默认阻止所有入站需要手动加规则。4.2 现象大文件传到 99% 卡住然后超时原因控制连接的空闲超时到了。FTP 协议里数据连接传输时控制连接是空闲的如果Timeout设得比文件传输时间短服务端会主动断开控制连接。解决把Timeout设大比如 3600 秒。或者客户端开启NOOP保活定期发空命令维持控制连接。PCMans FTP Server 源码里对NOOP的处理就是返回 200不做事但能刷新超时计时器。4.3 现象中文文件名变成乱码原因FTP 协议本身没有规定文件名编码PCMans FTP Server 默认用系统 ANSI 代码页。客户端如果按 UTF-8 解析就乱码。解决在配置文件里找UTF8相关选项如果有的话没有的话就在客户端侧设置编码为 GBK 或 CP936。FileZilla 在站点管理器里有字符集选项选“使用自定义字符集”填 GBK。命令行客户端基本无解建议文件名全用英文。4.4 现象服务启动时报“端口已被占用”原因21 端口被 IIS 的 FTP 服务或其他 FTP 软件占了。Windows 上netstat -ano | findstr :21能看到占用进程的 PID。解决要么停掉占用进程要么把 PCMans FTP Server 的端口改成 2121 或其他高位端口。改端口后客户端连接时要显式指定端口浏览器访问 FTP 链接也要写成ftp://ip:2121。4.5 现象多网卡机器上被动模式返回错误 IP原因服务端自动检测 IP 时选了错误的网卡。比如机器有内网 IP 192.168.1.10 和公网 IP 203.0.113.5服务端可能返回内网 IP 给公网客户端。解决在配置文件里手动指定PassiveIP为公网 IP。如果客户端来自内网就填内网 IP。这个参数不支持按客户端来源动态切换所以要么分开跑两个实例要么只服务一类客户端。5. 从源码里偷师把 FTP 服务嵌进自己的工具链PCMans FTP Server 的源码结构清晰适合拿来改造成自己需要的形态。比如你可以在嵌入式开发流程里把它编译成一个后台服务开机自启配合脚本自动上传编译产物。下面是一个用 Python 调用 FTP 上传固件的例子服务端就是 PCMans FTP Serverfrom ftplib import FTP import os def upload_firmware(host, port, user, passwd, local_file, remote_dir): ftp FTP() ftp.connect(host, port, timeout30) ftp.login(user, passwd) ftp.set_pasv(True) # 强制被动模式避免主动模式被防火墙拦 # 切换目录不存在则创建 try: ftp.cwd(remote_dir) except Exception: ftp.mkd(remote_dir) ftp.cwd(remote_dir) # 以二进制模式上传 with open(local_file, rb) as f: ftp.storbinary(fSTOR {os.path.basename(local_file)}, f) # 验证文件大小 remote_size ftp.size(os.path.basename(local_file)) local_size os.path.getsize(local_file) assert remote_size local_size, fSize mismatch: {remote_size} vs {local_size} ftp.quit() print(fUploaded {local_file} successfully) # 调用示例 upload_firmware(192.168.1.100, 2121, admin, secret, ./build/firmware.bin, /firmware/v1.2)这段代码的关键点set_pasv(True)强制被动模式在跨防火墙场景下比主动模式可靠storbinary用二进制模式传输避免文本模式下的换行符转换上传后校验文件大小防止传输中断导致的静默失败。参数方面timeout30是连接超时大文件传输时storbinary本身没有超时参数靠的是控制连接的NOOP保活。如果你要改源码最值得动的地方是命令解析循环里的日志输出。默认实现几乎不打日志出问题只能靠抓包。在SendResponse函数里加一行写文件记录时间戳、客户端 IP、命令和响应码排错效率能提升一个数量级。另一个值得改的是被动端口的分配策略默认是随机选改成从端口池里顺序取方便防火墙规则管理。我自己的习惯是任何轻量级服务上线前先用wireshark抓一次完整的登录加传输流程把控制连接和数据连接的包序看清楚。这个习惯帮我省掉了无数次“明明配置没问题但就是连不上”的后悔药。PCMans FTP Server 因为源码可读抓包对照源码看半小时就能把 FTP 协议的双连接模型刻进脑子里。希望帮到你。本文还有配套的精品资源点击获取 PCMan‘s FTP Server：轻量级开源FTP服务端在Windows上的部署与源码解析
简介PCMans FTP Server 是一款面向计算机初学者的开源 FTP 服务端软件主打「简单易用」帮助不熟悉网络配置的用户快速搭建基础 FTP 服务器无需深入理解协议细节即可完成文件共享。资源包共 143 个文件以 34 个 cpp 源文件、39 个 h 头文件为核心配合 43 个 ini 配置项、4 个 dsp 工程文件与 4 个 rc 资源脚本另有 ico、bmp 图标位图及 plg、aps 等辅助文件整体压缩后仅 154KB体积轻巧便于携带与二次编译。目前已有 202 人学习下载适合作为 C 网络编程入门、MFC 界面开发或小型 FTP 服务搭建的参考案例。通过阅读源码读者可了解 FTP 命令解析、用户管理、主框架与对话框交互等模块的组织方式并借助工程文件在旧版开发环境中直接编译运行快速理解一个轻量级服务端从界面到通信的完整实现思路。1. PCMans FTP Server一个被低估的轻量级开源方案如果你在 Windows 上折腾过 FTP 服务大概率经历过这样的场景FileZilla Server 装完发现配置项多到眼花Serv-U 功能全但要收费IIS 的 FTP 模块又跟系统绑得太死。这时候有人丢给你一个不到 200KB 的单文件程序双击就能跑配置文件是纯文本源码在 GitHub 上躺着——这就是 PCMans FTP Server一个用 Delphi 写的开源轻量级 FTP 服务端。它解决的核心问题很具体在 Windows 环境下快速搭一个能用的 FTP 服务不需要装运行时、不需要配数据库、不需要理解复杂的权限模型。适合谁嵌入式开发时给板子传固件、内网做文件分发、老设备维护时临时开个共享通道或者你就是想读一份结构清晰的 FTP 协议实现源码。开源意味着你能看到每一条命令怎么被解析、每一个响应码怎么被返回这对理解 FTP 协议本身比看 RFC 文档直观得多。2. 先搞清楚 FTP 协议的控制流与数据流为什么它比 HTTP 难伺候2.1 双连接模型21 端口只负责说话数据走另一条路FTP 跟 HTTP 最大的区别在于它用两条 TCP 连接。控制连接固定在 21 端口客户端登录、发命令、收响应码都走这条线数据连接是临时建立的传文件列表、传文件内容走这条线。这个设计在 1971 年很合理但在 NAT 和防火墙普及之后就成了万恶之源。PCMans FTP Server 的源码里控制连接的会话状态用TSession结构体维护每个客户端一个实例。数据连接有两种建立方式主动模式PORT下服务端从 20 端口主动连客户端被动模式PASV下服务端开一个随机端口等客户端来连。源码里TFTPServer类处理监听TSession处理命令解析两者通过回调函数通信。理解这个模型的意义在于你配置防火墙时不能只开 21 端口。主动模式要放行服务端出站的 20 端口被动模式要放行一个端口范围。很多“连上了但列不出目录”的问题根源都在这里。2.2 命令解析循环从 USER 到 QUIT 的完整链路PCMans FTP Server 的命令处理逻辑很直白核心是一个while循环读控制连接的缓冲区按空格切分命令和参数然后走case分支。下面是从源码结构里提炼出的伪代码逻辑帮你理解它怎么处理一条命令// 控制连接主循环基于源码逻辑重构 procedure TSession.Execute; var CmdLine: string; Cmd, Param: string; begin SendResponse(220 PCMan FTP Server ready); while not Terminated do begin CmdLine : ReadLineFromControlSocket; // 阻塞读超时 300 秒 SplitCommand(CmdLine, Cmd, Param); // 按第一个空格切分 Cmd : UpperCase(Cmd); if Cmd USER then SendResponse(331 Password required) else if Cmd PASS then begin if CheckAuth(Param) then SendResponse(230 Logged in) else SendResponse(530 Login incorrect); end else if Cmd PASV then EnterPassiveMode; // 开随机端口返回 227 响应 else if Cmd LIST then SendDirectoryList; // 通过数据连接发送 // ... 其余命令分支 end; end;这段逻辑说明几个关键点USER和PASS是分离的服务端在收到USER后返回 331 等待密码PASV命令触发被动模式服务端需要绑定一个新端口并告诉客户端LIST和RETR这类命令会触发数据连接的建立。参数说明方面ReadLineFromControlSocket的超时时间在源码里是硬编码的改大了会占资源改小了客户端容易断。2.3 主动模式与被动模式的选型判断什么时候用主动、什么时候用被动我的经验是客户端在 NAT 后面就用被动服务端在 NAT 后面就用主动。但现实情况往往是两边都在 NAT 后面这时候被动模式加端口映射是唯一出路。PCMans FTP Server 的被动模式实现里端口范围可以在配置文件里指定。常见做法是设一个窄范围比如 50000-50010然后在防火墙和路由器上把这个范围映射到服务端内网 IP。主动模式则要求服务端能出站连客户端的随机端口在云主机上基本不可用因为安全组默认不放行出站到高位端口。提示如果你在云主机上跑 PCMans FTP Server直接禁用主动模式只留被动模式能省掉一半的排错时间。3. 在 Windows 上把 PCMans FTP Server 跑起来从编译到第一个文件传输3.1 获取源码与编译环境准备PCMans FTP Server 是 Delphi 项目源码托管在 GitHub 上。你需要 Delphi 7 或更高版本才能编译Lazarus 也能凑合但可能需要改几处 Windows API 调用。如果不想装 Delphi直接下载作者预编译的 exe 也行但改配置和看源码是两回事。编译步骤大致如下# 1. 克隆仓库假设你已经装了 git git clone https://github.com/pcman-bbs/pcman-ftp-server.git # 2. 进入目录找到项目文件 cd pcman-ftp-server ls *.dpr # 应该能看到 PCManFTPServer.dpr # 3. 用 Delphi 命令行编译需要配置 dcc32 到 PATH dcc32 PCManFTPServer.dpr -E.\bin # 4. 编译产物在 bin 目录下 ls bin/如果你用 Lazarus打开.lpi文件后直接按 F9 编译。注意 Lazarus 下Windows单元的一些函数签名可能不同遇到Invalid floating point operation之类的报错检查SysUtils和Windows的引用顺序。3.2 配置文件逐项解读哪些参数必须改哪些可以不动PCMans FTP Server 的配置文件是纯文本通常叫ftpserver.ini或类似名字。下面是一个典型配置的逐项说明[Server] Port21 ; 控制端口改成 2121 可以避开 IIS 占用 MaxUsers10 ; 最大并发连接数按内存给每个会话约 1MB Timeout300 ; 控制连接空闲超时秒内网可以设 600 WelcomeMessageWelcome to PCMan FTP [Passive] PassivePortStart50000 ; 被动模式起始端口 PassivePortEnd50010 ; 被动模式结束端口范围别开太大 PassiveIP ; 留空则自动检测多网卡时手动填公网 IP [Users] ; 格式用户名密码:主目录:权限 adminsecret:C:\ftp\admin:RW guestguest:C:\ftp\public:R参数说明MaxUsers设太大没意义Windows 下每个连接占一个线程10 到 20 个并发对普通机械硬盘已经够呛。Timeout设太短会导致大文件传输中途断连设太长会积累僵尸会话。PassiveIP在多网卡机器上必须手动指定否则服务端返回的 IP 可能是内网地址客户端连不上。3.3 用命令行客户端验证服务是否正常服务跑起来之后别急着用 FileZilla 图形界面先用命令行验证能排除掉一半的客户端配置问题# 连接控制端口 ftp -p 127.0.0.1 2121 # 登录 Name: admin Password: secret # 查看当前目录 ftp ls # 切换被动模式命令行默认可能是主动 ftp passive # 下载一个测试文件 ftp get test.bin # 上传一个文件 ftp put upload.txt # 退出 ftp bye-p参数表示被动模式Windows 的 ftp 命令和 Linux 下行为略有不同。如果ls卡住不动多半是数据连接没建起来检查被动端口范围是否被防火墙拦了。如果登录就失败看服务端控制台有没有打印认证失败的日志。3.4 权限模型与目录隔离的实操PCMans FTP Server 的权限模型很简单每个用户绑定一个主目录权限只有读和写两个维度。没有虚拟目录、没有配额、没有 IP 白名单。这意味着你不能用它做多租户隔离但做单用户文件分发绰绰有余。配置多用户时每个用户在[Users]段占一行。主目录路径不要用中文和空格Delphi 的字符串处理在某些代码页下会出玄学问题。权限字段RW表示读写R表示只读W表示只写上传目录常用。如果你需要用户登录后直接进某个子目录把主目录指到那个子目录就行没有chroot的概念用户能通过cd ..逃逸——这是设计上的取舍不是 bug。4. 避坑与排查那些让你怀疑人生的连接问题4.1 现象客户端显示“已连接”但目录列表为空原因数据连接没有成功建立。主动模式下服务端连客户端的 20 端口被防火墙拦了被动模式下客户端连服务端的随机端口被拦了。解决先用ftp -p强制被动模式测试。如果被动模式正常说明主动模式出站被拦在服务端防火墙加一条出站规则放行 20 端口。如果被动模式也列不出目录检查PassivePortStart和PassivePortEnd之间的端口是否在防火墙入站规则里放行。Windows 防火墙默认阻止所有入站需要手动加规则。4.2 现象大文件传到 99% 卡住然后超时原因控制连接的空闲超时到了。FTP 协议里数据连接传输时控制连接是空闲的如果Timeout设得比文件传输时间短服务端会主动断开控制连接。解决把Timeout设大比如 3600 秒。或者客户端开启NOOP保活定期发空命令维持控制连接。PCMans FTP Server 源码里对NOOP的处理就是返回 200不做事但能刷新超时计时器。4.3 现象中文文件名变成乱码原因FTP 协议本身没有规定文件名编码PCMans FTP Server 默认用系统 ANSI 代码页。客户端如果按 UTF-8 解析就乱码。解决在配置文件里找UTF8相关选项如果有的话没有的话就在客户端侧设置编码为 GBK 或 CP936。FileZilla 在站点管理器里有字符集选项选“使用自定义字符集”填 GBK。命令行客户端基本无解建议文件名全用英文。4.4 现象服务启动时报“端口已被占用”原因21 端口被 IIS 的 FTP 服务或其他 FTP 软件占了。Windows 上netstat -ano | findstr :21能看到占用进程的 PID。解决要么停掉占用进程要么把 PCMans FTP Server 的端口改成 2121 或其他高位端口。改端口后客户端连接时要显式指定端口浏览器访问 FTP 链接也要写成ftp://ip:2121。4.5 现象多网卡机器上被动模式返回错误 IP原因服务端自动检测 IP 时选了错误的网卡。比如机器有内网 IP 192.168.1.10 和公网 IP 203.0.113.5服务端可能返回内网 IP 给公网客户端。解决在配置文件里手动指定PassiveIP为公网 IP。如果客户端来自内网就填内网 IP。这个参数不支持按客户端来源动态切换所以要么分开跑两个实例要么只服务一类客户端。5. 从源码里偷师把 FTP 服务嵌进自己的工具链PCMans FTP Server 的源码结构清晰适合拿来改造成自己需要的形态。比如你可以在嵌入式开发流程里把它编译成一个后台服务开机自启配合脚本自动上传编译产物。下面是一个用 Python 调用 FTP 上传固件的例子服务端就是 PCMans FTP Serverfrom ftplib import FTP import os def upload_firmware(host, port, user, passwd, local_file, remote_dir): ftp FTP() ftp.connect(host, port, timeout30) ftp.login(user, passwd) ftp.set_pasv(True) # 强制被动模式避免主动模式被防火墙拦 # 切换目录不存在则创建 try: ftp.cwd(remote_dir) except Exception: ftp.mkd(remote_dir) ftp.cwd(remote_dir) # 以二进制模式上传 with open(local_file, rb) as f: ftp.storbinary(fSTOR {os.path.basename(local_file)}, f) # 验证文件大小 remote_size ftp.size(os.path.basename(local_file)) local_size os.path.getsize(local_file) assert remote_size local_size, fSize mismatch: {remote_size} vs {local_size} ftp.quit() print(fUploaded {local_file} successfully) # 调用示例 upload_firmware(192.168.1.100, 2121, admin, secret, ./build/firmware.bin, /firmware/v1.2)这段代码的关键点set_pasv(True)强制被动模式在跨防火墙场景下比主动模式可靠storbinary用二进制模式传输避免文本模式下的换行符转换上传后校验文件大小防止传输中断导致的静默失败。参数方面timeout30是连接超时大文件传输时storbinary本身没有超时参数靠的是控制连接的NOOP保活。如果你要改源码最值得动的地方是命令解析循环里的日志输出。默认实现几乎不打日志出问题只能靠抓包。在SendResponse函数里加一行写文件记录时间戳、客户端 IP、命令和响应码排错效率能提升一个数量级。另一个值得改的是被动端口的分配策略默认是随机选改成从端口池里顺序取方便防火墙规则管理。我自己的习惯是任何轻量级服务上线前先用wireshark抓一次完整的登录加传输流程把控制连接和数据连接的包序看清楚。这个习惯帮我省掉了无数次“明明配置没问题但就是连不上”的后悔药。PCMans FTP Server 因为源码可读抓包对照源码看半小时就能把 FTP 协议的双连接模型刻进脑子里。希望帮到你。本文还有配套的精品资源点击获取