Docker启动Keycloak时环境变量未生效问题求助

核心问题：.env文件路径错误 #

你的standalone.sh中尝试加载当前工作目录下的.env文件，但实际.env位于/opt/keycloak/bin/目录，而容器启动时的WORKDIR是/opt/keycloak，路径匹配失败导致.env未被加载。

修复步骤 #

1. 修正standalone.sh中的.env路径 #

修改dotenv函数里的文件路径，改为相对WORKDIR的路径或者绝对路径：

dotenv () {
  set -a
  # 相对路径：当前WORKDIR是/opt/keycloak，bin/.env为正确路径
  [ -f ./bin/.env ] && . ./bin/.env
  # 或者用绝对路径更稳妥：
  # [ -f /opt/keycloak/bin/.env ] && . /opt/keycloak/bin/.env
  set +a
}
dotenv
echo "Loaded DB_ADDR: $DB_ADDR" # 增加日志确认加载状态

2. 确保.env文件权限正确 #

在Dockerfile中添加权限设置，保证keycloak用户能读取该文件：

COPY ./.env /opt/keycloak/bin/
RUN chown keycloak:keycloak /opt/keycloak/bin/.env # 新增权限配置

3. 替代方案：直接在CMD中加载.env（无需修改standalone.sh） #

如果不想修改standalone.sh，可以在Dockerfile的CMD中直接加载.env：

CMD ["/bin/sh", "-c", "set -a; . /opt/keycloak/bin/.env; set +a; exec $KEYCLOAK_HOME/bin/standalone.sh -b 0.0.0.0"]

使用exec让Keycloak进程成为容器PID 1，方便信号处理。

4. 验证环境变量是否生效 #

启动容器后，通过以下命令进入容器检查变量：

docker exec -it <容器ID> env

查看输出中是否包含.env里的变量，同时查看容器启动日志中echo $DB_ADDR的输出，确认加载是否成功。

额外建议 #

• 优先使用Keycloak官方镜像（如quay.io/keycloak/keycloak），官方镜像原生支持环境变量配置，无需手动处理.env文件，配置更可靠。
• 数据库连接等关键配置，也可通过standalone.xml或启动参数-D直接传递，例如：

$KEYCLOAK_HOME/bin/standalone.sh -b 0.0.0.0 -Ddb.vendor=postgres -Ddb.addr=172.0.0.1

内容的提问来源于stack exchange，提问作者Елена Ковалинская