如何在Keycloak管理控制台客户端配置中使用.env环境变量？

方法1：直接引用环境变量（Keycloak 17+ 推荐） #

Keycloak从17版本（Quarkus重构版）开始，支持在客户端配置字段中直接引用容器内的环境变量，格式为${env:环境变量名}，完美适配Docker的.env配置方式。

• 1. 定义.env变量
     在项目根目录创建.env文件，根据环境配置客户端根URL：

# 开发环境
MY_APP_ROOT_URL=http://localhost:3000
# 生产环境替换为实际地址
# MY_APP_ROOT_URL=https://my-production-app.com

• 2. Docker容器注入环境变量
     用Docker Compose或docker run命令，将.env中的变量注入Keycloak容器。以下是Docker Compose示例：

version: '3.8'
services:
  keycloak:
    image: quay.io/keycloak/keycloak:22.0.5
    env_file:
      - .env
    command: start-dev # 生产环境替换为 start --optimized
    ports:
      - "8080:8080"
    environment:
      KEYCLOAK_ADMIN: admin
      KEYCLOAK_ADMIN_PASSWORD: admin

• 3. 管理控制台配置客户端
     进入目标领域的客户端设置页面，将Root URL、Valid Redirect URIs等字段设置为${env:MY_APP_ROOT_URL}（如果需要匹配子路径，可写${env:MY_APP_ROOT_URL}/*）。保存后，Keycloak会自动解析容器内的环境变量值，开发和生产环境自动切换对应URL。

方法2：SPI扩展兼容旧版本（可选） #

如果使用Keycloak 16及以下的WildFly版本，或需要更复杂的变量逻辑，可通过自定义SPI实现：

• 编写简单的SPI代码，读取系统属性/环境变量，替换客户端配置中的自定义占位符（如${my.app.root.url}）。
• 将SPI打包为JAR，放入Keycloak的providers目录，Docker部署时挂载该目录到容器内的/opt/keycloak/providers。
• 在客户端配置中使用自定义占位符，由SPI自动替换为对应环境的值。

注意事项 #

• 确认Keycloak版本：Quarkus版本（17+）默认支持${env:VAR}格式，无需额外配置。
• 生产环境部署时，可通过CI/CD工具直接注入生产环境变量，或替换.env文件内容。
• 验证变量是否生效：进入容器执行docker exec -it <容器ID> printenv MY_APP_ROOT_URL，确认变量已正确注入。

内容的提问来源于stack exchange，提问作者Heitor