适用条件与现象
适用于你有权限使用的 FTP 服务,登录已成功但目录列表或文件传输超时。SFTP 使用不同协议,不适用 EPSV/PASV 排查;不能只凭文件扩展名判断传输方式。
先区分原因
FTP 控制会话和数据传输分开。curl 默认使用被动模式,并先尝试 EPSV;控制端口登录成功不能证明服务端协商的数据连接也能通过当前网络。
按顺序操作
- 记录协议、客户端版本和失败阶段,保留已能登录的配置。先用已知的小目录复现,不对大型目录连续重试,也不把密码写进共享命令或日志。
- 在同一授权目标上确认客户端使用被动模式。使用 curl 时,--ftp-pasv 可明确覆盖先前设置的主动模式;认证沿用本地安全配置,不在示例里暴露账号。
- 查看本地脱敏后的协议日志,确定是协商数据连接后超时,还是服务端直接拒绝列表。前者交由管理员检查被动端口范围和网络策略;后者先查目录权限。
- 只有怀疑 EPSV 兼容性且目标为 IPv4 时,临时加 --disable-epsv 做一次对照。它改用 PASV,不是切换到主动模式;对 IPv6 目标该选项无效。
怎样确认结果
同一目录能够完整列出,且一个有权限的小文件能完成传输,才证明数据连接恢复。记录普通被动模式和对照模式各自结果;登录欢迎信息或空输出都不能替代目录验收。
失败后的恢复与下一步
对照无效时移除 --disable-epsv,恢复原设置并交给服务管理员分析。不要为一次列表失败关闭防火墙或随意开放全部高端口;长期采用哪种模式需与服务端配置一致。