Jenkins管理员密码丢失后可通过两种方式恢复：一是检查初始密码文件/var/lib/jenkins/secrets/initialAdminPassword（Linux）或对应Windows路径；二是临时禁用安全机制，修改config.xml中useSecurity为false并重启服务，进入后重置密码并恢复安全策略。
Jenkins管理员密码丢失后无法登录系统管理界面，构建任务停滞、权限配置冻结，必须通过服务器文件层操作快速恢复访问权限。
检查初始密码文件是否存在
如果这是Jenkins首次安装且从未修改过管理员密码，系统会自动生成一个初始密码并保存在固定路径中。该密码仅在首次启动时有效，一旦完成初始化向导即被清空，因此必须立即检查。
执行命令查找初始密码文件：sudo cat /var/lib/jenkins/secrets/initialAdminPassword。若返回一串32位十六进制字符，说明密码仍可用；若提示“No such file or directory”，则跳转至下一节。
Windows用户请检查：C:\Program Files (x86)\Jenkins\secrets\initialAdminPassword 或 %USERPROFILE%\.jenkins\secrets\initialAdminPassword。
临时禁用安全机制进入系统
此方法适用于所有Jenkins版本，核心是关闭全局安全开关，让系统以无认证模式运行一次，从而获得重置入口。
第一步：备份原始配置文件，防止误操作导致服务不可用：sudo cp -a /var/lib/jenkins/config.xml /var/lib/jenkins/config.xml.bak.$(date +%Y%m%d_%H%M)。
第二步：编辑主配置文件：sudo vim /var/lib/jenkins/config.xml。
第三步：定位到 <useSecurity>true</useSecurity> 行，将其改为 <useSecurity>false</useSecurity>。【注意：不要删除整段securityRealm或authorizationStrategy区块，仅修改useSecurity值即可，否则重启后可能报错退出】
第四步：保存退出，重启Jenkins服务：sudo systemctl restart jenkins。等待10～15秒，直接访问 http://your-jenkins-url 即可免密进入。
重置admin用户密码并恢复安全策略
方法一：通过Web界面重置（推荐）
进入系统后，依次点击「系统管理」→「全局安全配置」→ 在「安全域」下选择「Jenkins专有用户数据库」→ 勾选「允许用户注册」→ 保存。
此时左侧菜单会出现「用户管理」，点击进入 → 找到 admin 用户 → 点击「设置」→ 在「密码」字段输入新密码 → 保存。
方法二：直接修改用户配置文件（适用于界面异常时）
执行命令定位admin用户配置：ls -d /var/lib/jenkins/users/admin_*/config.xml 2>/dev/null。通常返回类似 /var/lib/jenkins/users/admin_1234567890abcdef/config.xml 的路径。
用vim打开该文件，找到 <passwordHash> 标签，将其内容替换为新密码的BCrypt哈希值。生成方式：在Python中运行 import bcrypt; print(bcrypt.hashpw(b"your_new_password", bcrypt.gensalt()).decode())。
修改完成后，必须将 config.xml 中的 <useSecurity> 值改回 true，再重启服务。
