能否使用Jenkins的GIT插件将代码检出至远程目录？

阿华AIGC实验室

2026-5-26

能否借助Jenkins的Git插件将代码检出到远程目录？

当然可以实现这个需求，但要明确一点：Jenkins的Git插件本身不直接支持将代码直接检出到远程服务器的目录——它的默认行为是把代码拉取到Jenkins agent（或master节点）的本地工作目录中。不过我们可以通过几种间接的方式达成目标，下面是最常用的几种方案：

方案一：Git拉取本地 + SSH同步到远程

这种方法适合大多数场景，步骤简单易上手：

第一步：配置Jenkins节点（agent或master）与远程服务器的SSH免密登录。可以生成SSH密钥对，将公钥添加到远程服务器的~/.ssh/authorized_keys文件中，确保Jenkins用户能无密码登录远程服务器。
第二步：在Jenkins项目中，先用Git插件正常拉取代码到Jenkins本地工作区。

第三步：添加一个「执行shell」（Linux/macOS）或「执行Windows批处理命令」（Windows）步骤，用rsync或scp工具把本地工作区的代码同步到远程目录。示例命令：

# 用rsync同步，保留文件属性并删除远程多余文件
rsync -avz --delete ${WORKSPACE}/ user@your-remote-server:/path/to/target/directory/

如果远程服务器也部署了Git环境，也可以在远程目录初始化一个Git仓库，然后从Jenkins本地推送代码过去，再在远程目录拉取：

# 先在远程服务器手动执行一次（或通过Jenkins SSH步骤）
# git init --bare /path/to/remote/repo.git

# 在Jenkins本地工作区执行推送
git remote add remote-origin user@your-remote-server:/path/to/remote/repo.git
git push remote-origin main

# 最后在远程目标目录拉取最新代码
ssh user@your-remote-server "cd /path/to/target/directory && git pull /path/to/remote/repo.git main"

方案二：Git插件 + Publish Over SSH插件

借助Jenkins的Publish Over SSH插件，可以更直观地完成代码传输：

第一步：在Jenkins插件管理中搜索并安装Publish Over SSH插件。
第二步：进入Jenkins全局配置，找到「Publish over SSH」选项，添加远程服务器的连接信息（IP地址、端口、用户名、SSH密钥等），测试连接确保能正常访问。
第三步：在Jenkins项目中，先用Git插件拉取代码到本地工作区。
第四步：添加「Send files or execute commands over SSH」构建步骤：
- 选择配置好的远程服务器；
- 设置「Source files」为**/*（表示同步工作区所有文件）；
- 「Remote directory」填写远程服务器的目标路径；
- 可选：勾选「Delete remote files before transfer」，确保远程目录是干净的最新代码；
- 还可以在「Exec command」中添加传输完成后的操作，比如安装依赖、重启服务：
```
cd /path/to/target/directory && npm install && systemctl restart your-service
```

方案三：挂载远程目录到Jenkins节点

如果你的Jenkins节点是Linux系统，可以通过NFS或SSHFS将远程服务器的目录挂载到Jenkins节点的本地路径：

用SSHFS挂载示例：

# 安装SSHFS（以Debian/Ubuntu为例）
sudo apt-get install sshfs
# 创建本地挂载点
sudo mkdir /mnt/remote-code
# 赋予Jenkins用户挂载权限
sudo chown jenkins:jenkins /mnt/remote-code
# 挂载远程目录
sshfs user@your-remote-server:/path/to/target/directory /mnt/remote-code