21.6. 主机名 v2

hostname

服务器所公开的地址。

可以是完整的 URL，也可以是主机名。当只提供主机名时，会从请求解析端口和上下文路径。

CLI: -- hostname
Env: KC_HOSTNAME

仅在启用 hostname:v2 功能时才可用

hostname-admin

用于访问管理控制台的地址。

如果您使用反向代理在与 hostname 选项中指定的不同地址上公开管理控制台，则使用这个选项。

CLI: --hostname-admin
Env: KC_HOSTNAME_ADMIN

仅在启用 hostname:v2 功能时才可用

hostname-backchannel-dynamic

启用动态解析回溯通道 URL，包括主机名、方案、端口和上下文路径。

如果您的应用程序通过私有网络访问 Keycloak，则设置为 true。如果设置为 true，则需要将 hostname 选项指定为完整的 URL。

CLI: --hostname-backchannel-dynamic
Env: KC_HOSTNAME_BACKCHANNEL_DYNAMIC

仅在启用 hostname:v2 功能时才可用

true,false （默认）

hostname-debug

切换可在 /realms/master/hostname-debug 访问的主机名调试页面。

CLI: --hostname-debug
Env: KC_HOSTNAME_DEBUG

仅在启用 hostname:v2 功能时才可用

true,false （默认）

hostname-strict

禁用从请求标头动态解析主机名。

在生产环境中，应始终设为 true，除非反向代理会覆盖 Host 标头。如果启用，则需要指定 hostname 选项。

CLI: --hostname-strict
Env: KC_HOSTNAME_STRICT

仅在启用 hostname:v2 功能时才可用

true （默认），false