jenkins怎么迁移服务器

Jenkins 迁移服务器，本质是把 Jenkins 的主目录（数据）+ 配置 + 插件 从旧服务器搬到新服务器。下面给你一套最稳妥、通用的做法。

一、先搞清楚 Jenkins 存在哪

默认主目录是：

• Linux：/var/lib/jenkins
• Windows：C:\Program Files (x86)\Jenkins
• 或环境变量：JENKINS_HOME

✅ 迁移的核心就是：JENKINS_HOME 整个目录

二、迁移前准备（旧服务器）

1. 停止 Jenkins

systemctl stop jenkins
# 或
service jenkins stop

2. 打包 Jenkins 主目录

tar -czvf jenkins_home.tar.gz /var/lib/jenkins

⚠️ 如果磁盘大，可以排除 workspace 和 jobs/*/builds

tar --exclude=/var/lib/jenkins/workspace \
    --exclude=/var/lib/jenkins/jobs/*/builds \
    -czvf jenkins_home.tar.gz /var/lib/jenkins

三、新服务器准备

1. 安装同版本 Jenkins

非常重要：版本尽量一致

java -version
jenkins --version

安装方式：

• yum / apt
• war 包
• docker（见后文）

2. 先别启动 Jenkins

四、迁移数据（核心步骤）

1. 传文件到新服务器

scp jenkins_home.tar.gz user@new-server:/opt/

2. 解压覆盖

systemctl stop jenkins
rm -rf /var/lib/jenkins
tar -xzvf jenkins_home.tar.gz -C /

3. 修复权限（Linux）

chown -R jenkins:jenkins /var/lib/jenkins

五、启动并验证

systemctl start jenkins

访问：

http://新服务器IP:8080

✅ 用户、任务、插件、凭据都在
❌ 如果白屏/报错，看日志：

tail -f /var/log/jenkins/jenkins.log

六、常见问题

1. 插件不兼容

• 升级 Jenkins 到新版本
• 或重新装插件

2. 凭据丢失

• 检查 credentials.xml
• 如果是云凭据，需重新绑定

3. 节点（Agent）连不上

• 更新节点 IP
• 重新生成 agent 密钥

七、Docker 版 Jenkins 迁移（简单）

docker stop jenkins
docker cp jenkins:/var/jenkins_home ./jenkins_home
# 新服务器
docker run -d -p 8080:8080 -v $PWD/jenkins_home:/var/jenkins_home jenkins/jenkins

八、最省事方案（推荐）

✅ 整目录拷贝 + 同版本 Jenkins ✅ 不重新建任务 ✅ 不丢历史

如果你愿意，可以告诉我：

• 旧/新服务器系统（CentOS / Ubuntu / Windows）
• 是否 Docker
• Jenkins 版本

我可以直接给你一步一步可复制的命令。