Apache VFS2 SFTP连接失败：算法协商错误及aes256-ctr不可用求助

核心结论 #

提示aes256-ctr is not available是客户端本地无法加载该加密算法的明确信号，和服务器无关，核心问题出在客户端的JDK加密策略、依赖库版本或配置上。

具体原因分析 #

1. JCE加密强度限制
   旧版本JDK（JDK 8u151之前）默认受出口管制限制，仅支持有限强度的加密算法，aes256这类强加密算法需要额外安装JCE无限制强度权限文件才能启用。JDK 9及以上版本已默认移除该限制，无需额外配置。

2. JSch版本过低
   VFS2的SFTP实现底层依赖JSch库，若使用的JSch版本过旧（如0.1.50及以前），可能不支持curve25519-sha256、aes256-gcm@openssh.com这类较新的算法，导致客户端无法匹配服务器要求的算法列表。

3. VFS2配置不完整
   仅配置密钥交换算法是不够的，需要显式指定加密算法列表，否则JSch会使用默认的算法集合，而默认集合可能不包含服务器允许的aes256系列算法。

修复步骤 #

• 检查并升级JDK/JCE策略

  • 若使用JDK 8u151之前版本：下载对应JDK版本的JCE无限制强度策略文件，替换JRE_HOME/lib/security目录下的local_policy.jar和US_export_policy.jar。
  • 若使用JDK 8u151及以上或JDK 9+：无需额外操作，默认已支持无限制加密强度。

• 升级JSch依赖版本
  将项目中的JSch依赖升级至最新稳定版（如0.1.55及以上），确保支持服务器要求的所有算法。

• 完善VFS2的SFTP配置
  在配置中显式指定密钥交换、加密算法列表，示例代码如下：

  // 获取SFTP配置构建器
  SftpFileSystemConfigBuilder configBuilder = SftpFileSystemConfigBuilder.getInstance();
  FileSystemOptions opts = new FileSystemOptions();
  
  // 设置密钥交换算法（匹配服务器允许的列表）
  configBuilder.setSessionConfig(opts, "kex", "curve25519-sha256,diffie-hellman-group-exchange-sha256");
  // 设置客户端→服务器、服务器→客户端的加密算法
  configBuilder.setSessionConfig(opts, "cipher.c2s", "aes256-ctr,aes256-gcm@openssh.com");
  configBuilder.setSessionConfig(opts, "cipher.s2c", "aes256-ctr,aes256-gcm@openssh.com");
  // 可选：开启调试日志排查细节
  configBuilder.setSessionConfig(opts, "LogLevel", "DEBUG");
  

• 开启调试日志验证
  通过设置JSch的LogLevel为DEBUG，可以查看客户端与服务器的算法协商细节，确认客户端提供的算法列表是否与服务器的允许列表存在交集，进一步定位问题。

内容的提问来源于stack exchange，提问作者Mélanie