如何备份CentOS Jenkins

在 CentOS 上备份 Jenkins，通常包含 Jenkins 主目录、插件、任务配置、用户数据 等。下面给你一套常用且可靠的备份方案，从简单到完整。

一、Jenkins 核心目录说明（先搞清楚要备份什么）

Jenkins 默认主目录是：

/var/lib/jenkins

主要包含：

目录 / 文件	作用
`jobs/`	所有 Job / Pipeline 配置
`plugins/`	已安装插件
`users/`	用户配置
`config.xml`	Jenkins 全局配置
`secrets/`	凭证、密钥（非常重要）
`nodes/`	节点配置
`workspace/`	构建工作空间（一般可不备份）

✅ 重点备份：/var/lib/jenkins

二、最常用备份方式（推荐 ✅）

1️⃣ 停止 Jenkins（避免数据不一致）

systemctl stop jenkins

2️⃣ 打包 Jenkins 主目录

cd /var/lib
tar -czvf jenkins_backup_$(date +%F).tar.gz jenkins

生成文件如：

jenkins_backup_2026-01-21.tar.gz

3️⃣ 备份到安全位置

例如：

cp jenkins_backup_*.tar.gz /data/backup/

或上传到远程服务器 / 对象存储。

4️⃣ 启动 Jenkins

systemctl start jenkins

三、只备份关键配置（轻量方案）

如果你只关心 配置 + 任务 + 插件（不备份 workspace）：

tar -czvf jenkins_config_backup.tar.gz \
  /var/lib/jenkins/config.xml \
  /var/lib/jenkins/jobs \
  /var/lib/jenkins/plugins \
  /var/lib/jenkins/users \
  /var/lib/jenkins/secrets

✅ 恢复快、体积小

四、使用 Jenkins 插件备份（图形化）

安装插件

ThinBackup
Backup Plugin

ThinBackup 推荐 ✅

路径：

Manage Jenkins → ThinBackup → Settings

设置：

备份目录
是否备份 plugins
是否备份 secrets
定时备份

优点：

不用停服务
操作简单

缺点：

插件版本兼容性需注意

五、恢复 Jenkins（重要 ⚠️）

1️⃣ 停止 Jenkins

systemctl stop jenkins

2️⃣ 恢复备份文件

tar -xzvf jenkins_backup_2026-01-21.tar.gz -C /var/lib/

确保权限正确：

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

3️⃣ 启动 Jenkins

systemctl start jenkins

六、定期自动备份（cron 示例）

crontab -e

0 2 * * * tar -czvf /backup/jenkins_$(date +\%F).tar.gz /var/lib/jenkins

✅ 每天凌晨 2 点自动备份

七、Docker 部署的 Jenkins（补充）

如果 Jenkins 是 Docker 启动的：

docker stop jenkins
docker cp jenkins:/var/jenkins_home /backup/jenkins_home
docker start jenkins

或直接备份挂载目录：

/var/jenkins_home

八、备份最佳实践建议 ✅

✔ 至少备份 secrets/ 和 plugins/
✔ 恢复前先测试环境
✔ 不要只备份 jobs（缺插件很容易炸）
✔ 配合 Git 管理 Pipeline 脚本

九、常见坑提醒 ⚠️

问题	原因
恢复后插件报错	插件版本不一致
凭证丢失	没备份 `secrets/`
权限错误	文件属主不是 jenkins

如果你愿意，我也可以帮你：

✅ 写 一键备份脚本
✅ 区分 生产 / 测试环境备份策略
✅ 给你 Ansible / Shell 自动化方案

直接告诉我你的 Jenkins 是 rpm 安装 / Docker / Kubernetes 即可。