部署完成 jenkins 后,若需在构建过程中连接并操作远程服务器(如执行部署脚本、重启服务等),需预先配置 ssh 连接能力。具体步骤如下:
1、访问 Jenkins 管理界面,进入「系统配置」模块,在节点管理区域新增一台基于 SSH 协议的远程主机节点,并按提示填写主机地址、认证方式、凭据及端口等必要信息。
2、从左侧导航栏点击「系统管理」,再选择「系统设置」,进入全局配置中心进行后续
操作。
3、滚动至「SSH Remote Hosts」(SSH 远程主机)配置区,依据界面指引逐项填写目标服务器信息,确认无误后点击「保存」完成配置。
4、特别注意:若未将连接超时(timeout)参数设为 0,Jenkins 在尝试建立 SSH 连接时可能报出“Cant connect to server”错误。此时查阅 Tomcat 日志,常可见类似 org.jvnet.hudson.plugins.SSHBuildWrapper$DescriptorImpl.doLoginCheck 的异常堆栈,表明 SSH 登录校验阶段因超时而中断。该问题根源在于默认 timeout 值过短,无法适应网络延迟或服务器响应波动。为提升连接鲁棒性,强烈建议将 timeout 显式设为 0(即不限制等待时长),从而确保连接与身份验证过程顺利完成。已出现该问题的用户,可优先检查此项配置,调整后重试,通常可快速恢复远程执行功能,保障 CI/CD 流水线稳定运行。