jenkins：忘记密码怎么办

封面图 • 2025-11-22 • Linux

如果你在使用 Jenkins 时忘记了密码，可以通过以下几种方法来重置或找回密码。具体操作取决于你使用的 Jenkins 版本和配置方式（比如是否使用了插件、是否启用了 LDAP 或其他身份验证方式）。

---

## ✅ 方法一：通过 `credentials.xml` 文件重置密码（适用于本地用户）

### 步骤：

1. **找到 Jenkins 的安装目录**  
   通常 Jenkins 安装在 `/var/lib/jenkins/`（Linux）或 `C:\Program Files (x86)\Jenkins\`（Windows）等位置。

2. **进入 `user` 目录**  
   在 Jenkins 安装目录下找到 `user` 文件夹，例如：
   ```
   /var/lib/jenkins/users/your_username/
   ```

3. **编辑 `credentials.xml` 文件**  
   打开该文件，你会看到类似如下内容：
   ```xml
   <com.cloudbees.hudson.plugins.folder.AbstractFolder_-CredentialsProviderImpl>
       <id>some-id</id>
       <password>encrypted-password</password>
   </com.cloudbees.hudson.plugins.folder.AbstractFolder_-CredentialsProviderImpl>
   ```

4. **手动修改密码字段**  
   将 `<password>` 标签中的加密密码替换为明文密码，例如：
   ```xml
   <password>new-password</password>
   ```

5. **重启 Jenkins**  
   修改后，重启 Jenkins 服务以使更改生效。

6. **登录 Jenkins**  
   使用新设置的密码登录。

⚠️ 注意：这种方式仅适用于 Jenkins 内部用户（非 LDAP 或其他外部认证系统）。

---

## ✅ 方法二：使用 `jenkins-cli.jar` 重置密码（推荐）

### 步骤：

1. **获取 Jenkins CLI 工具**  
   在 Jenkins 安装目录中找到 `jenkins-cli.jar`，通常位于：
   - Linux: `/var/lib/jenkins/jenkins-cli.jar`
   - Windows: `C:\Program Files (x86)\Jenkins\jenkins-cli.jar`

2. **运行命令行工具**  
   打开终端或命令提示符，执行以下命令：

```bash
   java -jar jenkins-cli.jar -s http://localhost:8080/ set-password your-username new-password
   ```

替换 `your-username` 和 `new-password` 为你自己的用户名和新密码。

3. **重启 Jenkins**  
   如果没有自动生效，可以重启 Jenkins 服务。

4. **登录 Jenkins**  
   使用新密码登录。

---

## ✅ 方法三：使用管理员账户重置密码（如果已知管理员账号）

1. 登录 Jenkins 管理员账户。
2. 进入 **Manage Jenkins > Manage Users**。
3. 找到目标用户，点击 **Configure**。
4. 在 **Password** 字段中输入新密码并保存。

---

## ✅ 方法四：删除用户并重新创建（不推荐，但有效）

1. 停止 Jenkins。
2. 删除用户目录（如 `/var/lib/jenkins/users/your-username/`）。
3. 重启 Jenkins。
4. 重新创建用户并设置密码。

---

## ✅ 方法五：使用插件（如 "Matrix Authorization" 或 "Role Strategy"）

如果你使用的是权限控制插件（如 Matrix 或 Role Strategy），请确保你拥有足够的权限来重置密码。

---

## 🚨 注意事项

- 如果你使用的是 Jenkins 的远程服务器（如云服务器），请确保你有 SSH 访问权限。
- 如果 Jenkins 配置了 LDAP 或 SSO，忘记密码可能需要联系管理员。
- 不建议直接修改 `credentials.xml`，除非你了解其结构和加密方式。

---

如果你告诉我你是如何登录 Jenkins 的（比如是本地用户、LDAP、GitHub 等），我可以提供更具体的帮助！