You need to enable JavaScript to run this app. Delphi 10.x Indy TIdFTP SSL连接报错10054 证书类问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

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;
      

故障触发位置的快速判断

  • 如果10054错误在AUTH TLS命令发送后立刻触发,优先排查证书校验问题
  • 如果10054在账号密码验证完成、发起目录列表/文件传输时触发,优先排查IPv6适配、TLS会话复用的配置问题

内容的提问来源于stack exchange,提问作者Alcor Prism

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 16:36:03