Jenkins发布插件SSH连接初始化失败，认证出错如何解决？

报错详情 #

jenkins.plugins.publish_over.BapPublisherException: 无法连接并初始化SSH连接。详情：[无法为配置[WebService]连接会话。信息[认证失败]]

排查与解决步骤 #

• 核对SSH认证信息
  • 若使用密码认证：检查Jenkins中「WebService」配置的密码是否与目标服务器SSH登录密码完全匹配，注意大小写、特殊字符，避免输入错误
  • 若使用密钥对认证：
    1. 确认Jenkins配置的私钥完整无格式错误，复制时不要遗漏开头-----BEGIN RSA PRIVATE KEY-----和结尾-----END RSA PRIVATE KEY-----
    2. 目标服务器的~/.ssh/authorized_keys文件必须添加对应公钥，同时将文件权限设为600，目录权限设为700
• 手动验证SSH连通性
  • 用本地SSH客户端（如OpenSSH）直接连接目标服务器，确认能正常登录，排除网络不通、服务器SSH服务未启动、端口被防火墙拦截等问题
• 更新Publish Over SSH插件
  • 旧版本插件可能存在认证bug，前往Jenkins插件管理页面将Publish Over SSH更新至最新稳定版后重试
• 检查服务器地址与端口
  • 确认「WebService」配置中的服务器IP/域名、SSH端口（默认22）与实际服务器一致，避免地址或端口拼写错误

配置参考截图 #

• SSH配置界面：
• 认证设置界面：

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