JSch项目中的SSH算法协商失败问题分析与解决方案

原创于 2025-06-13 09:02:59 发布 · 255 阅读

CC 4.0 BY-SA版权

JSch项目中的SSH算法协商失败问题分析与解决方案

jsch fork of the popular jsch library 项目地址: https://gitcode.com/gh_mirrors/jsc/jsch

问题背景

在使用JSch库进行SSH连接时，经常会遇到"Algorithm negotiation fail"错误。这个问题通常发生在客户端(JSch)和服务器端支持的加密算法不匹配的情况下。具体表现为客户端提供的算法列表与服务器端支持的算法没有交集，导致连接失败。

错误分析

典型的错误信息会显示类似以下内容：

com.jcraft.jsch.JSchAlgoNegoFailException: Algorithm negotiation fail: algorithmName="server_host_key" 
jschProposal="ssh-ed25519,ecdsa-sha2-nistp256,ecdsa-sha2-nistp384,ecdsa-sha2-nistp521,rsa-sha2-512,rsa-sha2-256" 
serverProposal="ssh-rsa,ssh-dss"

从错误信息可以看出：

客户端(JSch)支持的算法是现代加密算法
服务器端只支持较旧的ssh-rsa和ssh-dss算法
两者没有共同的算法，导致协商失败

根本原因

这个问题源于现代SSH安全标准的演进。较新版本的JSch出于安全考虑，默认禁用了被认为不够安全的旧算法(如ssh-rsa和ssh-dss)。然而，许多旧服务器仍然只支持这些算法。

解决方案

方法一：修改JSch配置

可以通过修改JSch的配置来启用旧算法：

// 添加ssh-rsa和ssh-dss到服务器主机密钥算法列表
JSch.setConfig("server_host_key", JSch.getConfig("server_host_key") + ",ssh-rsa,ssh-dss");

// 添加ssh-rsa和ssh-dss到公钥认证算法列表
JSch.setConfig("PubkeyAcceptedAlgorithms", JSch.getConfig("PubkeyAcceptedAlgorithms") + ",ssh-rsa,ssh-dss");

方法二：在Jenkins中的实现

对于使用Jenkins SSH插件的用户，可以通过Groovy脚本修改JSch配置：

@Library('your-shared-library') _

// 在初始化阶段修改JSch配置
void initJschConfig() {
    JSch jsch = new JSch()
    jsch.setConfig("server_host_key", "ssh-ed25519,ecdsa-sha2-nistp256,ecdsa-sha2-nistp384,ecdsa-sha2-nistp521,rsa-sha2-512,rsa-sha2-256,ssh-rsa,ssh-dss")
    jsch.setConfig("PubkeyAcceptedAlgorithms", "ssh-ed25519,ecdsa-sha2-nistp256,ecdsa-sha2-nistp384,ecdsa-sha2-nistp521,rsa-sha2-512,rsa-sha2-256,ssh-rsa,ssh-dss")
}

pipeline {
    agent any
    
    stages {
        stage('Setup') {
            steps {
                script {
                    initJschConfig()
                }
            }
        }
        stage('Connect') {
            steps {
                script {
                    def remote = [
                        name: 'ssrpc',
                        user: username,
                        host: ip,
                        password: password,
                        allowAnyHosts: true
                    ]
                    sshCommand remote: remote, command: "your_command"
                }
            }
        }
    }
}