Jenkins 是一款功能強大的自動化服務(wù)器，在持續(xù)集成與交付（CI/CD）領(lǐng)域應(yīng)用廣泛。不過，用戶在使用過程中，尤其是首次接觸該系統(tǒng)或系統(tǒng)重啟后，常常會遇到登錄方面的問題。要是 Jenkins 突然要求輸入用戶名和密碼，而你又不知道去哪里找，別著急，這篇指南會告訴你原因以及如何重新獲取訪問權(quán)限。

一、了解 Jenkins 認證機制

（一）首次登錄（基于密鑰）

在初次安裝 Jenkins 時，系統(tǒng)采用的是基于密鑰的認證方式。通常會生成一個初始管理員密碼，并將其存儲在 Jenkins 主目錄下的某個文件中。完成初始設(shè)置以及配置管理員賬戶時，就需要用到這個密碼。

（二）后續(xù)登錄（用戶名和密碼）

完成初始設(shè)置后，登錄 Jenkins 就得使用用戶名和密碼了。要是你之前跳過了創(chuàng)建管理員賬戶這一步，或者忘記了登錄憑證，那就得想辦法找回或重置，才能重新登錄系統(tǒng)。

二、查找 Jenkins 憑證的位置

（一）初始管理員密碼（首次設(shè)置時）

初始管理員密碼的存儲位置如下：

• Linux 系統(tǒng)：/var/lib/jenkins/secrets/initialAdminPassword
• Windows 系統(tǒng)：%JENKINS_HOME%\secrets\initialAdminPassword

獲取密碼的方法如下：

• 使用文本編輯器或命令行工具打開相應(yīng)文件。
  • Linux 系統(tǒng)下，在終端輸入cat /var/lib/jenkins/secrets/initialAdminPassword。
  • Windows 系統(tǒng)則用記事本或其他文本編輯器打開文件。
• 然后使用獲取到的密碼，以admin為用戶名進行登錄。

（二）自定義管理員憑證（完成設(shè)置后）

如果在設(shè)置過程中創(chuàng)建了管理員賬戶，那就使用當時配置的用戶名和密碼登錄。要是忘記了這些憑證，那就繼續(xù)往下看如何重置。

三、解決登錄問題的步驟

（一）獲取初始管理員密碼（適用于設(shè)置未完成的情況）

• 按照前面說的方法找到initialAdminPassword文件。
• 以admin為用戶名，用獲取到的密碼登錄系統(tǒng)。

（二）重置憑證（已經(jīng)設(shè)置過管理員用戶但忘記憑證時）

這里有兩種方法供你選擇：

方法一：通過配置文件重置密碼

• 停止 Jenkins 服務(wù)：
  • Linux 系統(tǒng)下，在終端輸入sudo systemctl stop jenkins。
  • Windows 系統(tǒng)則從服務(wù)應(yīng)用程序中找到 Jenkins 服務(wù)并停止它。
• 編輯config.xml文件：
  • 先找到 Jenkins 的主目錄。
  • 打開config.xml文件，找到<useSecurity>true</useSecurity>這個標簽。
  • 把它改成<useSecurity>false</useSecurity>或者直接刪除這個標簽。
• 重啟 Jenkins 服務(wù)：
  • Linux 系統(tǒng)下，在終端輸入sudo systemctl start jenkins。
  • Windows 系統(tǒng)則從服務(wù)應(yīng)用程序中重啟 Jenkins 服務(wù)。
• 此時無需憑證即可登錄。登錄后重新啟用安全設(shè)置，并創(chuàng)建新的管理員用戶。

方法二：通過命令行或腳本控制臺創(chuàng)建新管理員用戶

• 打開 Jenkins 的命令行界面（CLI）或腳本控制臺。
• 運行以下 Groovy 腳本創(chuàng)建新的管理員用戶：
  jenkins.model.Jenkins.instance.securityRealm.createAccount('newAdmin', 'newPassword')
• 最后使用新創(chuàng)建的用戶名和密碼登錄系統(tǒng)。

四、憑證管理的最佳實踐

• 安全存儲：將 Jenkins 憑證妥善保存在密碼管理器中，確保安全。
• 定期備份：定期備份 Jenkins 的配置文件和主目錄，以防萬一。
• 外部認證：考慮將 Jenkins 與 LDAP 或 SSO 等外部認證系統(tǒng)集成，簡化用戶管理工作。

雖然 Jenkins 登錄問題可能會讓人頭疼，但只要了解了認證過程，知道如何找回或重置憑證，就能快速解決問題，重新獲得系統(tǒng)訪問權(quán)限。按照本指南的步驟操作，你就能輕松應(yīng)對這些挑戰(zhàn)，維持一個安全高效的 CI/CD 環(huán)境。