如何从SSH远程主机复制文件至Jenkins Server？sshpass无法使用

我懂你遇到的麻烦了——用sshpass在Jenkins的Execute shell里没输出也没反应，大概率是Jenkins运行用户的权限、环境变量配置或者sshpass本身的路径问题导致的，甚至可能是第一次连接远程主机需要确认密钥被非交互式shell屏蔽了。与其死磕这个，不如用Jenkins官方支持的插件来搞定，稳定性和可维护性都强多了。下面给你推荐几个好用的方案：

这是Jenkins官方维护的插件，功能覆盖远程命令执行、文件上传/下载，完全能满足你从远程主机拉文件到Jenkins的需求：

• 第一步：先配置远程主机凭据
  进入Jenkins的「系统管理」→「系统配置」，找到「SSH servers」模块，添加你的远程主机信息（IP/域名、端口），然后关联已经在Jenkins凭据库中保存的用户名+密码或者SSH密钥对（强烈推荐用密钥对，比明文密码安全）。
• 第二步：在项目中配置拉取文件
  如果是Freestyle项目，添加「SSH Publisher」构建步骤：
  • 选择你刚才配置好的远程主机
  • 操作类型选「Retrieve files」（这是关键，别选错成发送文件了）
  • 填写远程目录（比如/home/remote-user/data/）、要拉取的文件名（比如backup.tar.gz或者*.log）
  • 本地目录填Jenkins服务器上的目标路径，推荐用环境变量比如${WORKSPACE}/downloads/，这样文件会存在当前项目的工作空间里，后续步骤也能方便调用
• Pipeline用户福利
  如果用Jenkinsfile，直接用插件提供的Pipeline语法，比如：

  sshPublisher(publishers: [
    sshPublisherDesc(
      configName: '你的远程主机配置名',
      transfers: [
        sshTransfer(
          remoteDirectory: '/home/remote-user/data/',
          includes: 'backup.tar.gz',
          retrieveFiles: true,
          localDirectory: "${WORKSPACE}/downloads/"
        )
      ]
    )
  ])
  

  这个插件的优势是完全不需要在Jenkins服务器上装额外工具，控制台会输出详细的传输日志，出问题也好排查。

如果你只需要单纯的文件传输，不需要执行远程命令，这个插件更适合你，它基于SCP协议，配置更简洁：

• 同样先在Jenkins凭据库中添加远程主机的登录凭据
• 在Freestyle项目中添加「SCP」构建步骤，选择远程主机，填写远程文件路径和本地目标路径即可
• 优点是轻量、配置步骤少，没有多余功能，适合只做文件同步的场景

如果还是想搞清楚为什么sshpass不行，大概率是这几个问题：

• Jenkins的运行用户（通常是jenkins用户）没有权限执行sshpass，或者sshpass不在Jenkins的PATH环境变量里（可以在Execute shell里先执行which sshpass看看能不能找到）
• 第一次连接远程主机需要确认主机密钥，而sshpass在非交互式shell下没处理这个，导致卡住（可以先手动用jenkins用户执行一次ssh remote-host确认密钥，或者在命令里加上-o StrictHostKeyChecking=no跳过验证）
• 密码或者文件路径写错了，但sshpass的错误输出被Jenkins的shell吞了，加上-v参数（sshpass -v -p 'xxx' scp ...）就能看到详细日志了

不过还是强烈推荐用插件方案，不仅安全（不用在shell里写明文密码），而且Jenkins会帮你处理各种环境和权限问题，省心多了。

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