Jenkins自动更新后跳转至安装引导 原有配置丢失如何恢复

前置操作 #

先停掉当前运行的Jenkins服务，避免新写入的数据覆盖旧配置，不同系统停服务命令参考：

• Debian/Ubuntu/RHEL/CentOS 系统：sudo systemctl stop jenkins
• Windows系统：打开服务管理器，找到Jenkins服务右键选择停止
• macOS（brew安装）：brew services stop jenkins-lts

恢复步骤 #

1. 确认核心目录路径 #

首先确认两个路径：

• 当前Jenkins的主目录（JENKINS_HOME）默认路径：
  • Linux：/var/lib/jenkins
  • Windows：C:\Program Files\Jenkins 或 C:\Windows\System32\config\systemprofile\.jenkins
  • macOS：/Users/Shared/Jenkins 或 ~/.jenkins
    如果之前自定义过主目录，就用你自定义的路径
• 你本地留存的旧Jenkins相关文件，确认是完整的旧JENKINS_HOME目录，里面必须包含config.xml、users目录、secrets目录、jobs目录、plugins目录这些核心内容

2. 替换主目录内容 #

• 先把当前Jenkins主目录下的所有内容备份到其他无关路径，避免操作失误导致二次问题
• 删除当前Jenkins主目录下的全部文件
• 把你留存的所有旧Jenkins文件完整复制到当前Jenkins主目录路径下
• Linux/macOS系统需要修正目录权限，确保Jenkins运行用户有读写权限：sudo chown -R jenkins:jenkins 你的Jenkins主目录路径，Windows系统跳过这一步

3. 启动验证 #

执行对应系统的Jenkins启动命令启动服务，比如Linux下执行sudo systemctl start jenkins，等待服务启动完成后访问Jenkins页面，原有账户、任务、插件配置都会正常加载，不会再跳转安装向导。

异常排查 #

• 若启动后仍跳转安装向导：检查你复制的旧文件中是否包含secrets目录和根目录下的config.xml文件，这两个是识别原有安装状态的核心文件，缺的话从旧文件里找齐替换即可
• 若账户登录失败：检查旧文件的users目录是否完整复制，权限配置是否正确
• 若插件全部丢失：确认旧文件的plugins目录已经完整复制到新主目录下，重启服务即可生效

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