如何配置Jenkins Master SSH连接slave时用指定用户而非默认jenkins？

首先明确核心逻辑：Jenkins 通过SSH方式启动Agent节点时，连接所用的SSH用户身份完全由节点配置里关联的SSH凭证决定，和Jenkins Master服务本身的系统运行用户（比如默认的jenkins用户）没有绑定关系。之前出现默认拿jenkins用户连Slave的问题，本质是你给Slave1节点绑的SSH凭证本身存的就是jenkins用户的身份信息，根本没关联上UserZ的凭证，不是Jenkins故意硬用默认用户连接。

前置准备工作 #

• 在Slave1节点上提前创建好UserZ系统账号，配置好可正常登录的SSH权限，确保从Jenkins Master节点的网络可以无阻碍连通Slave1的SSH端口（默认22，自定义端口可对应调整）
• 为Jenkins生成专用的SSH密钥对，不建议复用现有pmandal、系统jenkins用户的密钥，避免后续权限混乱。在Jenkins Master服务器上执行命令生成专属密钥：
  ssh-keygen -t rsa -b 4096 -f /var/lib/jenkins/.ssh/jenkins_slave_userz_rsa -N ""
• 将生成的公钥文件jenkins_slave_userz_rsa.pub的全部内容，追加到Slave1节点上UserZ账号的~/.ssh/authorized_keys文件中，同时确保目录、文件权限符合SSH服务的校验要求：
  • UserZ家目录下的.ssh目录权限设置为700，属主为UserZ
  • authorized_keys文件权限设置为600，属主为UserZ

在Jenkins中配置UserZ专属的SSH凭证 #

• 进入Jenkins UI的「Manage Jenkins」->「Credentials」->「System」->「Global credentials (unrestricted)」路径
• 新建凭证，类型选择「SSH Username with private key」
• 用户名字段必须填写目标连接账号UserZ，不要填错成其他用户
• 私钥字段粘贴之前生成的jenkins_slave_userz_rsa私钥完整内容
• 给凭证设置易识别的ID（比如slave1-userz-ssh），保存配置

修改Slave1节点的启动关联配置 #

• 回到「Manage Jenkins」->「Nodes」列表，找到Slave1节点进入配置页
• 找到「启动方法（Launch method）」板块，确认启动方式为「通过SSH启动agent（Launch agent via SSH）」
• 将「Credentials」下拉选项切换为刚才新建的、绑定了UserZ身份的SSH凭证，移除原来绑定的默认jenkins用户凭证
• 将节点的「远程工作目录」修改为UserZ账号下具备读写权限的路径（比如/home/UserZ/jenkins-agent），不要沿用原jenkins用户专属的目录路径，避免后续启动报权限错误

配置有效性验证 #

• 保存节点配置后返回Slave1节点详情页，点击「启动agent」按钮
• 查看节点的启动日志，确认日志中记录的SSH登录身份是UserZ，不再出现默认jenkins用户的连接记录
• 可在节点上执行简单的whoamishell命令做二次校验，确认后续agent运行、构建任务执行的所有操作，都是以UserZ身份完成的

常见避坑提示 #

• 无需修改Jenkins Master服务本身的运行用户身份，只要SSH凭证配置正确，Master可以同时使用不同的系统身份连接不同的Slave节点，不存在全局锁死用户的限制
• 若保存凭证后在节点配置的凭证下拉列表中找不到对应选项，检查凭证的作用域是否设置为全局，避免因作用域范围限制无法被节点选择
• 若SSH连接始终失败，优先查看Slave节点的SSH服务日志，确认是否因UserZ权限配置异常、密钥文件权限不对、SSH服务的登录策略拦截等原因导致连接被拒

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