Jenkins重置管理员密码

Jenkins重置管理员密码操作指南

适用场景 :忘记 Jenkins 管理员(admin)密码,且无法通过正常方式恢复。
重要提示:操作前务必备份配置,避免配置丢失导致服务异常。


步骤一:备份并临时关闭 Jenkins 安全认证

  1. 备份原始配置文件(强烈推荐)

    使用 cp -a 保留权限、时间戳等属性:

    bash 复制代码
    sudo cp -a /var/lib/jenkins/config.xml /var/lib/jenkins/config.xml.bak.$(date +%Y%m%d)

    示例备份文件名:config.xml.bak.20260117

  2. 编辑 Jenkins 主配置文件

    bash 复制代码
    sudo vim /var/lib/jenkins/config.xml
  3. 移除安全域配置(Security Realm)

    删除以下内容:

    xml 复制代码
    <securityRealm class="hudson.security.HudsonPrivateSecurityRealm">
      <disableSignup>true</disableSignup>
      <enableCaptcha>false</enableCaptcha>
    </securityRealm>
  4. 移除授权策略(Authorization Strategy)

    删除以下内容:

    xml 复制代码
    <authorizationStrategy class="hudson.security.FullControlOnceLoggedInAuthorizationStrategy">
      <denyAnonymousReadAccess>true</denyAnonymousReadAccess>
    </authorizationStrategy>

    ⚠️ 此操作将允许匿名访问 Jenkins,仅用于临时恢复,请勿长期保留。


步骤二:重启 Jenkins 服务

bash 复制代码
sudo systemctl restart jenkins

等待服务启动后,直接访问 Jenkins Web 界面(如 http://<your-jenkins-url>),此时无需登录即可进入系统。


步骤三:重置 admin 用户密码

  1. 进入 系统管理(Manage Jenkins)

  2. 点击 全局安全配置(Configure Global Security)

    • 安全域(Security Realm) 部分,选择:

      Jenkins 专有用户数据库(Jenkins' own user database)

      • 可选:勾选 允许用户注册(Allow users to sign up)
  3. 保存配置。

  4. 返回 系统管理 → 用户管理(Manage Users)

  5. 找到 admin 用户,点击 设置(Configure)

  6. 密码(Password) 字段中输入新密码,保存。


步骤四:恢复安全配置

为保障系统安全,必须重新启用认证和授权策略:

  1. 进入 系统管理 → 全局安全配置
  2. 安全域(Security Realm) :保持为 Jenkins 专有用户数据库
  3. 授权策略(Authorization) :根据环境选择:
    • 开发/测试:登录用户可以做任何事(Logged-in users can do anything)
    • 生产环境:建议使用 基于角色的策略(Role-Based Strategy) (需安装 Role Strategy Plugin
  4. 勾选 拒绝匿名用户读取访问(Prevent anonymous read access)(如需要)

✅ 此时 Web 界面配置会自动更新 config.xml,无需手动编辑。


恢复备份(可选)

若操作失败或需回滚,可使用备份恢复:

bash 复制代码
sudo cp -a /var/lib/jenkins/config.xml.bak.20260117 /var/lib/jenkins/config.xml
sudo systemctl restart jenkins

相关推荐
一方热衷.2 分钟前
在线安装对应版本NVIDIA驱动
linux·运维·服务器
独自归家的兔4 分钟前
ubuntu系统安装dbswitch教程 - 备份本地数据到远程服务器
linux·运维·ubuntu
ONE_SIX_MIX7 分钟前
ubuntu 24.04 用rdp连接,桌面黑屏问题,解决
linux·运维·ubuntu
龙飞058 分钟前
Systemd -systemctl - journalctl 速查表:服务管理 + 日志排障
linux·运维·前端·chrome·systemctl·journalctl
春日见10 分钟前
如何创建一个PR
运维·开发语言·windows·git·docker·容器
DARLING Zero two♡18 分钟前
告别 Docker 命令行!Portainer+cpolar 让容器管理从局域网走向公网
运维·docker·容器
消失的旧时光-194325 分钟前
Linux 编辑器入门:nano 与 vim 的区别与选择指南
linux·运维·服务器
斯普信专业组27 分钟前
构建基于MCP的MySQL智能运维平台:从开源服务端到交互式AI助手
运维·mysql·开源·mcp
vx_Biye_Design1 小时前
基于Spring Boot+vue的湖北旅游景点门票预约平台的设计--毕设附源码29593
java·vue.js·spring boot·spring cloud·servlet·eclipse·课程设计
liu****1 小时前
2.深入浅出理解虚拟化与容器化(含Docker实操全解析)
运维·c++·docker·容器·虚拟化技术