第 21 章 所有配置

cache

定义高可用性的缓存机制。

默认情况下，在生产环境模式中，使用 ispn 缓存在多个服务器节点之间创建集群。默认情况下，在开发模式中，本地缓存 会禁用集群，用于开发和测试目的。

CLI: -- cache
Env: KC_CACHE

ISPN （默认），local

cache-config-file

定义应从中加载缓存配置的文件。

配置文件相对于 conf/ 目录。

CLI: --cache-config-file
Env: KC_CACHE_CONFIG_FILE

cache-embedded-authorization-max-count

授权缓存可以存储在内存中的最大条目数。

CLI: --cache-embedded-authorization-max-count
Env: KC_CACHE_EMBEDDED_AUTHORIZATION_MAX_COUNT

cache-embedded-client-sessions-max-count

客户端Sessions 缓存可以存储在内存中的最大条目数。

CLI: --cache-embedded-client-sessions-max-count
Env: KC_CACHE_EMBEDDED_CLIENT_SESSIONS_MAX_COUNT

仅在配置了嵌入式 Infinispan 集群时可用

cache-embedded-crl-max-count

crl 缓存可以存储在内存中的最大条目数。

CLI: --cache-embedded-crl-max-count
Env: KC_CACHE_EMBEDDED_CRL_MAX_COUNT

cache-embedded-keys-max-count

密钥缓存可在内存中存储的最大条目数。

CLI: --cache-embedded-keys-max-count
Env: KC_CACHE_EMBEDDED_KEYS_MAX_COUNT

cache-embedded-mtls-enabled

加密 Keycloak 服务器之间的网络通信。

如果没有提供有关密钥存储和信任存储的额外参数，则会自动创建和轮转临时密钥对，这是标准设置的建议。

CLI: --cache-embedded-mtls-enabled
Env: KC_CACHE_EMBEDDED_MTLS_ENABLED

仅在使用基于 TCP 的 cache-stack 时可用

true （默认），false

cache-embedded-mtls-key-store-file

Keystore 文件路径。

Keystore 必须包含 TLS 协议使用的证书。默认情况下，它会在 conf/ 目录下查找 cache-mtls-keystore.p12。

CLI: --cache-embedded-mtls-key-store-file
Env: KC_CACHE_EMBEDDED_MTLS_KEY_STORE_FILE

仅在启用了属性 'cache-embedded-mtls-enabled' 时可用

cache-embedded-mtls-key-store-password

用于访问密钥存储的密码。

CLI: --cache-embedded-mtls-key-store-password
Env: KC_CACHE_EMBEDDED_MTLS_KEY_STORE_PASSWORD

仅在启用了属性 'cache-embedded-mtls-enabled' 时可用

cache-embedded-mtls-rotation-interval-days

自动 JGroups MTLS 证书轮转周期（以天为单位）。

CLI: --cache-embedded-mtls-rotation-interval-days
Env: KC_CACHE_EMBEDDED_MTLS_ROTATION_INTERVAL_DAYS

仅在启用了属性 'cache-embedded-mtls-enabled' 时可用

30 （默认）

cache-embedded-mtls-trust-store-file

Truststore 文件路径。

它应包含可信证书或签发证书的证书颁发机构。默认情况下，它会在 conf/ 目录下查找 cache-mtls-truststore.p12。

CLI: --cache-embedded-mtls-trust-store-file
Env: KC_CACHE_EMBEDDED_MTLS_TRUST_STORE_FILE

仅在启用了属性 'cache-embedded-mtls-enabled' 时可用

cache-embedded-mtls-trust-store-password

访问 Truststore 的密码。

CLI: --cache-embedded-mtls-trust-store-password
Env: KC_CACHE_EMBEDDED_MTLS_TRUST_STORE_PASSWORD

仅在启用了属性 'cache-embedded-mtls-enabled' 时可用

cache-embedded-offline-client-sessions-max-count

offlineClientSessions 缓存可以存储在内存中的最大条目数。

CLI: --cache-embedded-offline-client-sessions-max-count
Env: KC_CACHE_EMBEDDED_OFFLINE_CLIENT_SESSIONS_MAX_COUNT

仅在配置了嵌入式 Infinispan 集群时可用

cache-embedded-offline-sessions-max-count

offlineSessions 缓存可以存储在内存中的最大条目数。

CLI: --cache-embedded-offline-sessions-max-count
Env: KC_CACHE_EMBEDDED_OFFLINE_SESSIONS_MAX_COUNT

仅在配置了嵌入式 Infinispan 集群时可用

cache-embedded-realms-max-count

域缓存可以存储在内存中的最大条目数。

CLI: --cache-embedded-realms-max-count
Env: KC_CACHE_EMBEDDED_REALMS_MAX_COUNT

cache-embedded-sessions-max-count

会话缓存可以存储在内存中的最大条目数。

CLI: --cache-embedded-sessions-max-count
Env: KC_CACHE_EMBEDDED_SESSIONS_MAX_COUNT

仅在配置了嵌入式 Infinispan 集群时可用

cache-embedded-users-max-count

用户缓存可以存储在内存中的最大条目数。

CLI: --cache-embedded-users-max-count
Env: KC_CACHE_EMBEDDED_USERS_MAX_COUNT

cache-metrics-histograms-enabled

为嵌入式缓存的指标启用直方图。

CLI: --cache-metrics-histograms-enabled
Env: KC_CACHE_METRICS_HISTOGRAMS_ENABLED

仅在启用指标时可用

true,false （默认）

cache-remote-host

外部 Infinispan 集群的主机名。

仅在设置了功能 多站点、无集群或 cache-embedded-remote-store 时才可用。

CLI: --cache-remote-host
Env: KC_CACHE_REMOTE_HOST

cache-remote-password

对外部 Infinispan 集群进行身份验证的密码。

如果连接到不安全的外部 Infinispan 集群，则它是可选的。如果指定了这个选项，则需要 cache-remote-username。

CLI: --cache-remote-password
Env: KC_CACHE_REMOTE_PASSWORD

仅在设置远程主机时可用

cache-remote-port

外部 Infinispan 集群的端口。

CLI: --cache-remote-port
Env: KC_CACHE_REMOTE_PORT

仅在设置远程主机时可用

11222 （默认）

cache-remote-tls-enabled

启用 TLS 支持与安全远程 Infinispan 服务器通信。

建议在生产环境中启用。

CLI: --cache-remote-tls-enabled
Env: KC_CACHE_REMOTE_TLS_ENABLED

仅在设置远程主机时可用

true （默认），false

cache-remote-username

外部 Infinispan 集群身份验证的用户名。

如果连接到不安全的外部 Infinispan 集群，则它是可选的。如果指定了 选项，则需要 cache-remote-password。

CLI: --cache-remote-username
Env: KC_CACHE_REMOTE_USERNAME

仅在设置远程主机时可用

cache-stack

定义用于集群通信和节点发现的默认堆栈。

如果没有设置，则默认为 jdbc-ping。

CLI: --cache-stack
Env: KC_CACHE_STACK

仅在 'cache' type 设为 'ispn' 时才可用

使用 'jdbc-ping' 相反，方法是取消设置 Deprecated 值： azure,ec2,google,tcp,udp,jdbc-ping-udp

jdbc-ping,kubernetes,jdbc-ping-udp （已弃用）、tcp （已弃用）、udp （已弃用）、ec2 （已弃用）、azure （已弃用）、google （已弃用）或任何