Python ftplib连接FTP报425无法建立数据连接超时问题咨询

云上老周

2026-8-27

问题根因

从报错日志可以确认，FTP控制通道（21端口）的连接、认证流程完全正常，故障点全部集中在数据通道建立环节，和代码本身逻辑无关——NAS系统更新后重置FTP服务配置、恢复防火墙默认规则是这类故障的最高发诱因，两种模式的具体故障逻辑：

主动模式（set_pasv(False)）报425 Can't build data connection: Connection timed out：主动模式的传输逻辑是客户端随机开放一个本地端口，通过PORT命令将端口信息告知服务端，由NAS从20端口主动向客户端该端口发起连接建链。超时说明NAS发起的回连请求被拦截：要么是NAS更新后系统防火墙默认禁止了FTP服务20端口的出站权限，要么是客户端侧防火墙拦截了来自NAS的入站连接，少数情况是NAS更新后FTP服务绑定了错误的网卡IP，回连地址不可达。
被动模式（set_pasv(True)）报WinError 10060连接超时：被动模式的传输逻辑是NAS随机开放一个数据端口，通过PASV响应将端口信息告知客户端，由客户端主动向NAS该端口发起连接建链。超时说明客户端无法连通NAS返回的数据端口，这是NAS更新后最常见的故障：要么是FTP服务的被动模式端口段没有在NAS防火墙、上级路由放通，要么是PASV响应里返回的是NAS内网IP，和客户端实际访问的服务IP不一致，导致客户端连错地址超时。

解决方案

按优先级从高到低排查处理：

优先修复NAS侧FTP被动模式配置（覆盖90%以上同类故障）
- 登录NAS管理后台，找到FTP服务设置项，手动指定固定的被动模式端口范围（建议设为50000-50100区间，避免和其他服务端口冲突）
- 在NAS系统防火墙、上级路由器的端口转发规则中，放通上述被动模式端口段的TCP入站权限
- 在FTP服务设置中，将被动模式的“对外发布IP”手动设置为代码里配置的FTP_IP地址，不要使用默认的“自动获取内网IP”配置
- 配置完成后将代码中set_pasv设为True测试即可，被动模式对客户端网络环境兼容性更好，是目前FTP传输的首选模式
若需使用主动模式，补充配置防火墙规则
- 检查NAS系统防火墙，放通FTP服务20端口的TCP出站规则
- 关闭客户端本机的公网防火墙/安全软件，或添加规则放通来自NAS IP的20端口入站连接

代码侧兼容调整
补充超时、编码配置，排除ftplib默认参数兼容问题，可直接使用以下测试代码验证：

import ftplib
import os

ftp = ftplib.FTP()
# 显式指定连接超时，避免长时间挂起
ftp.connect(host=os.environ.get('FTP_IP'), port=21, timeout=10)
ftp.login(user=os.environ.get('FTP_LOGIN'), passwd=os.environ.get('FTP_PASS'))
ftp.set_pasv(True)
ftp.encoding = "utf-8"
ftp.set_debuglevel(2)
# 替换为实际本地文件路径
with open("local_file.csv", "rb") as f:
    ftp.storbinary("STOR myFile.csv", f, blocksize=1024)
ftp.quit()

端口连通性快速验证
无需运行代码，可直接通过命令行快速定位端口问题：
- 控制端口验证：执行telnet [你的FTP_IP] 21，能看到返回220开头的FTP欢迎信息即正常，和当前现象一致
- 被动模式数据端口验证：手动通过telnet连接21端口，发送PASV命令，拿到返回值格式为227 Entering Passive Mode (a,b,c,d,p1,p2)，计算数据端口为p1*256 + p2，再执行telnet [a.b.c.d] [计算出的端口]，能连通说明被动模式配置正常，连不通即可确认是NAS侧端口/IP配置问题。

内容的提问来源于stack exchange，提问作者Ruben Guillemyn