Keycloak 24.0.2：如何将基础路径访问自动重定向至自定义members领域的登录/注册页面

我正在为一家小型非营利组织使用Keycloak（24.0.2）作为独立的自注册应用（带有一些自定义字段）。Keycloak以Docker方式运行在Nginx后方，通过keycloak.myorganization.com提供服务。我配置了两个领域：master（默认领域）和members（供成员登录/注册的领域）。

我希望用户访问基础路径时能自动跳转到members领域的登录/注册页面。我已经将master领域的Frontend URL设置为keycloak.myorganization.com，members领域的设置为members.myorganization.com。同时修改了Docker环境变量：

KC_HOSTNAME=members.myorganization.com
KC_HOSTNAME_ADMIN=keycloak.myorganization.com

Nginx负责SSL终止，并通过proxy_pass将members.myorganization.com和keycloak.myorganization.com的请求都转发到本地Docker容器。

但问题是，当我访问https://members.myorganization.com时，会被重定向到管理控制台，而不是members领域的登录页面——members领域的登录页面实际是https://members.myorganization.com/realms/members/account/。

我该如何让https://members.myorganization.com直接重定向到https://members.myorganization.com/realms/members/account/？

在Keycloak迁移指南中提到：

如果启用了管理控制台，当管理员用户已存在时，欢迎页面会自动重定向到管理控制台。可以通过在theme.properties文件中设置redirectToAdmin属性来修改此行为。默认情况下，该属性设置为false，除非你扩展了内置主题，此时该属性会被设置为true。

这是不是意味着我必须创建/覆盖主题来修改重定向行为？

可行的解决方案 #

根据你的场景，有几种方法可以实现这个重定向需求，不一定非要修改主题，我们一个个来看：

方法1：通过Nginx直接添加重定向规则

既然你已经用Nginx做反向代理，这可能是最简单直接的方式。在members.myorganization.com的server配置块里，添加一条针对根路径的重定向规则：

server {
    listen 443 ssl;
    server_name members.myorganization.com;

    # 其他SSL相关配置...

    # 添加这条重定向规则
    location = / {
        return 302 /realms/members/account/;
    }

    # 原有的proxy_pass配置...
    location / {
        proxy_pass http://your-keycloak-docker-ip:port;
        # 其他proxy相关头配置...
    }
}

这样用户访问根路径时，Nginx会直接把请求重定向到members领域的账户页面，不需要经过Keycloak的欢迎页面逻辑。

方法2：修改Keycloak主题的theme.properties

如果更倾向于在Keycloak层面解决问题，那确实需要调整主题配置：

1. 先创建一个自定义主题（或者复制内置的keycloak主题作为基础）
2. 在主题的theme.properties文件中添加或修改：

   redirectToAdmin=false
   

3. 然后在Keycloak控制台的members领域设置中，将登录主题、账户主题等切换为你自定义的主题
4. 另外，你还可以自定义欢迎页面的重定向逻辑——比如修改主题的welcome.ftl模板，直接添加HTML meta重定向：

   <meta http-equiv="refresh" content="0; url=/realms/members/account/">
   

   这样即使欢迎页面加载，也会立刻跳转到目标页面。

方法3：使用Keycloak的启动参数或环境变量

在Keycloak 24版本中，你可以尝试添加额外的启动参数来调整欢迎页面行为，不需要自定义主题就能生效。比如在Docker环境变量中添加：

KC_SPI_THEME_WELCOME_REDIRECT_TO_ADMIN=false

这个参数对应主题SPI的配置，作用和修改theme.properties里的redirectToAdmin是一致的。

总结 #

如果你想快速解决，优先用Nginx的重定向规则，配置简单且不涉及Keycloak内部主题修改；如果希望所有逻辑都在Keycloak内部处理，那么选择修改主题或者添加启动参数的方式都可以。

备注：内容来源于stack exchange，提问作者Alex