Apache2+Nginx+Keycloak部署下管理控制台访问异常求助

我之前帮同事排查过几乎一模一样的场景，这种授权后跳转到空白控制台页面的情况，90%以上是Apache反向代理的配置问题，干扰了Keycloak的前端资源加载或者重定向逻辑。虽然看不到你的配置文件，但可以给你几个最常见的排查方向：

• 确保反向代理头部正确传递
  Keycloak严重依赖Host、X-Forwarded-For、X-Forwarded-Proto这些请求头来生成正确的前端资源路径和重定向URL。如果Apache没有正确传递这些头部，Keycloak会生成错误的资源地址，导致页面空白。
  你需要检查Apache配置里是否设置了：

  ProxyPreserveHost On
  RequestHeader set X-Forwarded-Proto "https"  # 如果你的外部访问是HTTPS的话
  RequestHeader set X-Forwarded-For "%{REMOTE_ADDR}s"
  

  这些配置能保证Keycloak拿到正确的请求上下文信息。

• 检查路径转发是否完整
  有时候Apache的重写规则或者代理配置会截断/auth路径下的子请求，比如Keycloak控制台需要加载/auth/admin/master/console/js/app.js这类静态资源，如果Apache没有把这些子请求完整转发到Nginx，就会导致资源404，页面变成空白。
  要确保Apache对/auth路径的代理规则是覆盖所有子路径的，比如：

  ProxyPass /auth http://your-nginx-ip:port/auth
  ProxyPassReverse /auth http://your-nginx-ip:port/auth
  

  不要在路径后面加额外的限制或者重写规则。

• 查看浏览器开发者工具定位具体问题
  打开浏览器的F12开发者工具，切换到「网络」标签，重新授权进入控制台，看看有没有404/500的请求（尤其是JS、CSS文件），或者控制台有没有报错信息。比如如果看到资源请求的协议是HTTP但你访问的是HTTPS，那就是X-Forwarded-Proto头部没传对；如果是资源路径错误，那就是路径转发有问题。

• 检查SSL终止后的头部传递
  如果Apache是SSL终止节点（用户访问Apache的HTTPS端口，Apache转发到Nginx的HTTP端口），一定要确保传递X-Forwarded-Proto: https给Nginx，否则Keycloak会认为请求是HTTP的，生成的前端资源URL会是HTTP，被浏览器的混合内容策略拦截，导致页面空白。

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