8.8. 相关选项

hostname

服务器所公开的地址。

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

CLI: -- hostname
Env: KC_HOSTNAME

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

hostname-admin

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

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

CLI: --hostname-admin
Env: KC_HOSTNAME_ADMIN

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

http-relative-path swig

设置用于服务资源的路径相对于 / 的路径。

该路径必须以 / 开头。

CLI: --http-relative-path
Env: KC_HTTP_RELATIVE_PATH

/ （默认）

proxy-headers

服务器应接受的代理标头。

错误配置可能会使服务器暴露于安全漏洞。优先于已弃用的代理选项。

CLI: --proxy-headers
Env: KC_PROXY_HEADERS

转发,xforwarded

proxy-protocol-enabled

服务器是否应该在代理后提供请求时使用 HA PROXY 协议。

当设置为 true 时，返回的远程地址将是实际连接客户端中的地址。

CLI: --proxy-protocol-enabled
Env: KC_PROXY_PROTOCOL_ENABLED

true,false （默认）

proxy-trusted-addresses

以逗号分隔的可信代理地址列表。

如果设置，则忽略来自其他地址的代理标头。默认情况下，所有地址都是可信的。可信代理地址被指定为 IP 地址(IPv4 或 IPv6)或无类别域间路由(CIDR)标记。仅在设置 proxy-headers 时可用。

CLI: --proxy-trusted-addresses
Env: KC_PROXY_TRUSTED_ADDRESSES