PHP ssh2_connect报错：无法交换加密密钥，求解决方案

• 验证PHP ssh2扩展与目标服务器的算法兼容性
  系统shell和WinSCP依赖的库与PHP ssh2扩展依赖的版本可能存在差异，即使系统libssh无更新，也要确认双方支持的加密算法集合：

  1. 用系统SSH获取服务器支持的算法：执行ssh -v data.example.com 22，在输出中找到服务器发送的加密算法、主机密钥类型等信息（比如debug1: kex algorithms: curve25519-sha256@libssh.org,ecdh-sha2-nistp256）。
  2. 确认PHP ssh2扩展依赖的libssh版本：执行ldd $(php -r "echo ini_get('extension_dir');")/ssh2.so，查看依赖的libssh文件版本，再核对该版本支持的算法列表。
  3. 对比两者的算法交集，找出可能不匹配的项。

• 强制指定兼容的连接参数
  在ssh2_connect调用中显式指定服务器支持的协议或加密算法，缩小协商范围：

  $connection = ssh2_connect('data.example.com', 22, [
      'hostkey' => 'ssh-rsa,ecdsa-sha2-nistp256', // 匹配服务器支持的主机密钥类型
      'ciphers' => 'aes256-gcm@openssh.com,aes128-gcm@openssh.com' // 匹配服务器支持的加密算法
  ]);
  

  参数值从ssh -v的输出中选取，优先选双方都支持的项。

• 检查主机密钥缓存与证书问题
  即使WinSCP能正常连接，PHP ssh2扩展可能使用了不同的主机密钥存储：

  1. 清除本地~/.ssh/known_hosts中对应服务器的条目，重新尝试连接，看是否触发主机密钥验证提示。
  2. 测试时可临时指定hostkey参数跳过验证（仅用于排查，生产环境禁用）：

     $connection = ssh2_connect('data.example.com', 22, ['hostkey' => 'ignore']);
     

• 重新编译/更新PHP ssh2扩展
  PHP7.0.33搭配的ssh2扩展版本可能较旧，存在密钥交换的兼容性问题：

  1. 安装编译依赖（如gcc, make, libssh-devel, php-devel）。
  2. 下载适配PHP7.0的ssh2扩展版本（如ssh2-1.3.1），编译安装：

     pecl install ssh2-1.3.1
     

  3. 重启PHP服务后重新测试连接。

• 通过系统调用跟踪排查细节
  用strace跟踪PHP进程的系统调用，获取密钥交换阶段的具体错误：

  strace -f php your_script.php 2>&1 | grep -i "ssh\|cipher\|key"
  

  从输出中查找是否存在算法查找失败、权限不足或资源缺失等问题。

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