You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Keycloak应使用哪个Docker镜像仓库?Quay.io镜像访问异常排查

部署场景

通过Docker Compose部署Keycloak时,使用以下配置的jboss/keycloak镜像可正常运行:

keycloak:
  image: jboss/keycloak
  container_name: keycloak
  restart: always
  environment:
    KEYCLOAK_USER: admin
    KEYCLOAK_PASSWORD: admin
  ports:
    - "8080:8080"

正常表现:创建名为wibble的Realm(重定向URL为*)和用户user1后,访问http://localhost:8080/auth/realms/wibble/account可出现登录提示。

异常情况

使用quay.io的Keycloak镜像时,上述URL返回「抱歉,页面未找到」,配置如下:

keycloak:
  image: quay.io/keycloak/keycloak:latest
  command: start-dev
  restart: always
  environment:
    KEYCLOAK_ADMIN: admin
    KEYCLOAK_ADMIN_PASSWORD: admin
  ports:
    - 8080:8080

额外现象:访问http://localhost:8080/会重定向到http://localhost:8080/auth/,同样返回页面未找到,但访问http://localhost:8080/admin可正常出现登录提示。

疑问与解答
  1. Quay.io的Keycloak镜像是否为更新、官方支持的版本?
    是的,quay.io/keycloak/keycloak是官方维护的最新Keycloak镜像,jboss/keycloak为旧版本镜像,已停止维护,官方目前主推quay.io上的镜像。

  2. 若结论成立,该Docker Compose配置出现问题的原因是什么?
    核心原因是路径前缀的版本变更:

  • 旧版jboss/keycloak以/auth作为所有端点的固定前缀,因此账户页面路径为/auth/realms/wibble/account。
  • 新版Keycloak(quay.io镜像)默认移除了/auth前缀,账户页面的正确路径应为http://localhost:8080/realms/wibble/account。
  • 根路径/重定向到/auth/是新版保留的旧路径兼容逻辑,但该路径已无对应资源,因此返回404;而/admin是新版控制台的正确路径,所以可正常访问。

内容的提问来源于stack exchange,提问作者fubgert234

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.13 01:57:11