如何修改Keycloak管理控制台URL中的默认Realm为自定义Realm？

云原生阿岚

2026-7-11

Keycloak管理控制台默认跳转Realm路径修改方法

问题背景

访问Keycloak管理控制台时，默认会跳转到https://<domain>/admin/master/console/，其中master是默认Realm（配图： Keycloak默认跳转至master Realm ），希望修改该URL中的Realm名称，让默认跳转指向自定义Realm，最终路径为https://<domain>/admin/<custom-realm>/console/。

答案

完全可以实现，有两种方式可选：

方式一：直接访问目标Realm控制台

不需要修改任何配置，直接在浏览器地址栏输入https://<domain>/admin/<custom-realm>/console/，就能直接进入自定义Realm的管理控制台——前提是你使用的管理员账号拥有该Realm的管理权限。

方式二：修改默认跳转配置（永久生效）

如果希望用户打开管理控制台入口时，自动跳转到自定义Realm，需要修改Keycloak的配置：

Keycloak 17及以上版本（Quarkus架构）：
可以在启动时添加命令行参数：
```
--spi-console-default-realm=<custom-realm>
```
也可以在keycloak.conf配置文件中添加一行：
```
spi-console-default-realm=<custom-realm>
```
Keycloak 16及以下版本（WildFly架构）：
找到standalone.xml或domain.xml配置文件，在<subsystem xmlns="urn:jboss:domain:keycloak-server:1.1">节点下添加或修改如下配置：
```
<spi name="console">
  <provider name="default" enabled="true">
    <properties>
      <property name="defaultRealm" value="<custom-realm>"/>
    </properties>
  </provider>
</spi>
```
修改完成后重启Keycloak服务，默认跳转路径就会改为自定义Realm。