Delphi 10.x Indy TIdFTP SSL连接报错10054 证书类问题咨询
故障根因定位与适配方案
从现有测试日志和Indy默认行为对比可确定,10054连接中断并非网络可达性问题,而是Indy默认配置和目标Pure-FTPd服务器的严格规则不匹配导致,按概率从高到低的根因如下:
1. 最高概率根因:IPv6优先的连接规则不匹配
- 从ftptest.net的测试日志可见,目标域名
s223.panelboxmanager.com首次解析到的地址是IPv6格式:2607:f748:1301:0:184:107:112:57,说明服务器侧优先开放IPv6连接通道。当前虚拟主机场景下的Pure-FTPd普遍会在安全配置中直接中断来源不匹配的IPv4连接,发送TCP RST包,对应Indy端看到的就是10054连接重置错误。 - Delphi 10.x自带的Indy 10版本默认仅启用IPv4协议栈,就算系统支持IPv6,Indy的域名解析也会优先返回IPv4记录,不会主动发起IPv6连接请求,刚好踩中服务器的连接拦截规则。而之前对接的OVH服务器没有做这个IPv4/IPv6的连接限制,所以默认配置可以正常运行。
- 适配代码补充:
// 给TIdFTP配置支持IPv6版本 FFtp.IPVersion := Id_IPv6;
2. 次高概率根因:TLS会话复用强制校验不兼容
- 测试日志明确标注数据连接流程:
TLS session of transfer connection has been resumed,说明该Pure-FTPd开启了强制数据连接复用控制连接TLS会话的安全规则,不允许数据连接发起全新的全量TLS握手。 - 旧版Indy(Delphi 10.3及以下自带的Indy 10.6.x版本)的默认SSL IOHandler实现,不会在控制连接和后续数据连接之间共享TLS会话上下文,每次建立数据连接时都会发起全新的TLS握手。服务器检测到会话不匹配时会主动中断连接,表现为10054错误。而OVH服务器没有开启这个强制校验规则,所以不会触发问题。
- 适配配置补充:
// 匹配服务器仅支持TLS1.2以上版本的规则,避免旧版本握手被拒 IdSSLIOHandlerSocketOpenSSL.SSLOptions.SSLVersions := [sslvTLSv1_2, sslvTLSv1_3]; // 开启内存模式的TLS会话缓存,自动在控制/数据连接间复用会话 IdSSLIOHandlerSocketOpenSSL.SSLOptions.SessionCacheSize := 10240; IdSSLIOHandlerSocketOpenSSL.SSLOptions.SessionTimeout := 300; // 强制使用被动模式,匹配服务器仅支持EPSV被动模式的规则 FFtp.Passive := True;
3. 低概率根因:证书校验的隐性阻断
- Indy的TIdSSLIOHandlerSocketOpenSSL默认开启严格证书链校验,如果代码中没有加载对应服务器证书的CA根证书(本次测试日志显示服务器证书签发方为AlphaSSL G2,根证书为GlobalSign Root CA),Indy在校验失败时不会直接抛出显性的证书错误,而是在握手阶段静默断开。服务器等待超时后会主动发送RST包,同样表现为10054错误。
- 排查与适配:
- 手动将对应CA证书文件放入程序运行目录,通过
IdSSLIOHandlerSocketOpenSSL.SSLOptions.CertFile指定CA证书包路径 - 临时添加
OnVerifyPeer事件返回True排除干扰,如果临时绕过证书校验可正常连接,即可确认是证书加载的问题:IdSSLIOHandlerSocketOpenSSL.OnVerifyPeer := IdSSLIOHandlerSocketOpenSSLVerifyPeer; function TForm1.IdSSLIOHandlerSocketOpenSSLVerifyPeer(Certificate: TIdX509; AOk: Boolean; ADepth, AError: Integer): Boolean; begin // 临时测试阶段返回True,正式环境建议补全证书校验逻辑 Result := True; end;
- 手动将对应CA证书文件放入程序运行目录,通过
故障触发位置的快速判断
- 如果10054错误在
AUTH TLS命令发送后立刻触发,优先排查证书校验问题 - 如果10054在账号密码验证完成、发起目录列表/文件传输时触发,优先排查IPv6适配、TLS会话复用的配置问题
内容的提问来源于stack exchange,提问作者Alcor Prism
相关产品推荐
相关产品推荐

