Kubernetes中Jenkins反复出现解锁页面及登录异常求助

在Kubernetes环境中部署Jenkins Agent时遇到以下问题：

• 首次加载解锁页面，通过kubectl logs获取管理员密码完成解锁，创建admin用户并安装默认插件及Kubernetes插件
• 重启Jenkins后，再次进入解锁页面，陷入循环
• 登录页面持续加载，输入正确账号密码提示无效；偶尔登录成功后，点击「Manage Jenkins」又跳转回登录页面

附当前config.xml内容：

<securityRealm class="hudson.security.HudsonPrivateSecurityRealm">
<disableSignup>true</disableSignup>
<enableCaptcha>false</enableCaptcha>
</securityRealm>
<disableRememberMe>false</disableRememberMe>
<projectNamingStrategy class="jenkins.model.ProjectNamingStrategy$DefaultProjectNamingStrategy"/>
<workspaceDir>${JENKINS_HOME}/workspace/${ITEM_FULL_NAME}</workspaceDir>
<buildsDir>${ITEM_ROOTDIR}/builds</buildsDir>
<jdks/>
<viewsTabBar class="hudson.views.DefaultViewsTabBar"/>
<myViewsTabBar class="hudson.views.DefaultMyViewsTabBar"/>
<clouds/>
<scmCheckoutRetryCount>0</scmCheckoutRetryCount>
<views>
<hudson.model.AllView>
  <owner class="hudson" reference="../../../"/>
  <name>all</name>
  <filterExecutors>false</filterExecutors>
  <filterQueue>false</filterQueue>
  <properties class="hudson.model.View$PropertyList"/>
</hudson.model.AllView>
</views>
<primaryView>all</primaryView>
<slaveAgentPort>50000</slaveAgentPort>
<label></label>
<crumbIssuer class="hudson.security.csrf.DefaultCrumbIssuer">
<excludeClientIPFromCrumb>false</excludeClientIPFromCrumb>
</crumbIssuer>
<nodeProperties/>
<globalNodeProperties/>
<nodeRenameMigrationNeeded>false</nodeRenameMigrationNeeded>
</hudson>

1. 检查Jenkins数据持久化状态 #

Kubernetes环境中，Jenkins重启后丢失配置最常见的原因是JENKINS_HOME目录未正确持久化：

• 执行kubectl exec -it <jenkins-pod-name> -- ls /var/jenkins_home/users，查看是否存在admin用户的文件夹（如admin_xxxx格式）
• 若文件夹不存在，说明持久化卷挂载失败或未配置，需检查Deployment/StatefulSet中的volumeMounts和volumes配置，确保数据能在Pod重启后保留

2. 修复config.xml的安全配置 #

当前config.xml的HudsonPrivateSecurityRealm节点缺少已创建用户的信息，且未配置授权策略，导致Jenkins无法识别已存在的管理员账户：

步骤1：临时关闭安全验证（紧急恢复） #

修改config.xml，替换安全域和授权策略配置：

<securityRealm class="hudson.security.SecurityRealm$None"/>
<authorizationStrategy class="hudson.security.AuthorizationStrategy$Unsecured"/>

• 执行kubectl cp config.xml <jenkins-pod-name>:/var/jenkins_home/config.xml覆盖原文件
• 重启Jenkins Pod：kubectl delete pod <jenkins-pod-name>
• 此时Jenkins会跳过登录直接进入管理界面

步骤2：重新配置安全设置 #

进入Jenkins管理界面后，重新配置安全规则：

• 进入「Manage Jenkins」→「Configure Global Security」
• 选择「Jenkins’ own user database」作为安全域，勾选「Allow users to sign up」（配置完成后可关闭）
• 选择「Logged-in users can do anything」作为授权策略
• 点击「Save」后，创建新的admin用户（或找回原用户）

步骤3：恢复完整安全配置（可选） #

若需保留原用户，可从备份的config.xml中提取用户节点，添加到HudsonPrivateSecurityRealm下，示例：

<securityRealm class="hudson.security.HudsonPrivateSecurityRealm">
  <disableSignup>true</disableSignup>
  <enableCaptcha>false</enableCaptcha>
  <users>
    <hudson.security.HudsonPrivateSecurityRealm$Details>
      <id>admin</id>
      <password>#jbcrypt:$2a$10$xxxxxx...（原加密密码）</password>
    </hudson.security.HudsonPrivateSecurityRealm$Details>
  </users>
</securityRealm>
<authorizationStrategy class="hudson.security.FullControlOnceLoggedInAuthorizationStrategy">
  <denyAnonymousReadAccess>true</denyAnonymousReadAccess>
</authorizationStrategy>

3. 排查插件冲突或会话问题 #

• 登录循环可能与插件冲突有关，可尝试在安全模式下启动Jenkins：在Pod启动命令中添加--enable-future-java --safe-mode，进入后禁用近期安装的插件（如Kubernetes插件），逐一排查
• 清除浏览器缓存和Cookie，或使用无痕模式访问，排除会话缓存问题
• 检查Jenkins的CSRF配置，确保crumbIssuer正常工作；若问题持续，可临时关闭CSRF验证（不推荐生产环境）

内容的提问来源于stack exchange，提问作者Keyan