当前位置：首页 > news >正文

安装 Jenkins 后无法访问用户名或密码且忘记这些凭证怎么办？

news 来源：原创 2025/6/7 3:47:36

Jenkins 是一款功能强大的自动化服务器，在持续集成与交付（CI/CD）领域应用广泛。不过，用户在使用过程中，尤其是首次接触该系统或系统重启后，常常会遇到登录方面的问题。要是 Jenkins 突然要求输入用户名和密码，而你又不知道去哪里找，别着急，这篇指南会告诉你原因以及如何重新获取访问权限。

在初次安装 Jenkins 时，系统采用的是基于密钥的认证方式。通常会生成一个初始管理员密码，并将其存储在 Jenkins 主目录下的某个文件中。完成初始设置以及配置管理员账户时，就需要用到这个密码。

完成初始设置后，登录 Jenkins 就得使用用户名和密码了。要是你之前跳过了创建管理员账户这一步，或者忘记了登录凭证，那就得想办法找回或重置，才能重新登录系统。

初始管理员密码的存储位置如下：

获取密码的方法如下：

使用文本编辑器或命令行工具打开相应文件。
- Linux 系统下，在终端输入cat /var/lib/jenkins/secrets/initialAdminPassword。
- Windows 系统则用记事本或其他文本编辑器打开文件。
然后使用获取到的密码，以admin为用户名进行登录。

如果在设置过程中创建了管理员账户，那就使用当时配置的用户名和密码登录。要是忘记了这些凭证，那就继续往下看如何重置。

这里有两种方法供你选择：

停止 Jenkins 服务：
- Linux 系统下，在终端输入sudo systemctl stop jenkins。
- Windows 系统则从服务应用程序中找到 Jenkins 服务并停止它。
编辑config.xml文件：
- 先找到 Jenkins 的主目录。
- 打开config.xml文件，找到<useSecurity>true</useSecurity>这个标签。
- 把它改成<useSecurity>false</useSecurity>或者直接删除这个标签。
重启 Jenkins 服务：
- Linux 系统下，在终端输入sudo systemctl start jenkins。
- Windows 系统则从服务应用程序中重启 Jenkins 服务。
此时无需凭证即可登录。登录后重新启用安全设置，并创建新的管理员用户。

打开 Jenkins 的命令行界面（CLI）或脚本控制台。
运行以下 Groovy 脚本创建新的管理员用户：
jenkins.model.Jenkins.instance.securityRealm.createAccount('newAdmin', 'newPassword')
最后使用新创建的用户名和密码登录系统。

虽然 Jenkins 登录问题可能会让人头疼，但只要了解了认证过程，知道如何找回或重置凭证，就能快速解决问题，重新获得系统访问权限。按照本指南的步骤操作，你就能轻松应对这些挑战，维持一个安全高效的 CI/CD 环境。