在REL 7.9 Docker容器部署Keycloak 20.0.3无HTTP响应求助

1. 验证REL 7.9的Docker版本兼容性 #

Keycloak 20.0.3的镜像依赖较新的Docker runtime特性，而REL 7.9默认搭载的Docker版本通常为1.13.x系列，可能无法适配高版本镜像的运行要求：

• 执行docker --version查看当前版本，若低于20.10.x，需升级REL 7.9上的Docker至官方支持的稳定版本（需配置对应yum源）
• 升级后重新启动容器，观察是否能正常启动

2. 排查容器底层库兼容性问题 #

REL 7.9的系统基础库（如glibc、openssl）版本偏低，若你的自定义镜像keycloak-mybuild:20.0.3基于较新的基础镜像（如ubi8/debian11），可能出现库依赖缺失导致进程无法启动：

• 进入容器后手动执行启动命令：/opt/keycloak/bin/kc.sh start --optimized，查看是否有明确的库报错信息
• 尝试将自定义镜像的基础镜像切换为ubi7（适配REL 7.9的系统库版本），重新构建后部署测试

3. 检查SELinux限制 #

REL 7.9默认开启SELinux，可能阻止容器进程绑定端口或访问系统资源：

• 临时关闭SELinux测试：setenforce 0，重启容器后验证服务是否正常
• 若临时关闭后恢复正常，需配置SELinux规则：
  • 允许容器绑定8080端口：semanage port -a -t http_port_t -p tcp 8080
  • 或在Docker Compose中添加SELinux标签配置：

    security_opt: ["label=type:container_runtime_t"]
    

4. 调整容器网络配置 #

REL 7.9的Docker网络驱动对自定义网络的兼容性有限：

• 在Compose中显式指定网络驱动为bridge（REL 7.9原生支持的驱动）：

  networks:
    namednetwork:
      driver: bridge
  

• 临时移除自定义网络配置，使用Docker默认网络测试容器启动情况

5. 修正Keycloak启动参数与环境变量 #

Keycloak 20.x对部分旧参数的兼容性在低版本系统上可能存在问题：

• 移除--optimized参数，仅保留start命令启动，查看是否输出日志
• 将旧参数PROXY_ADDRESS_FORWARDING=true替换为Keycloak 20推荐的KC_PROXY=edge
• 强制查看容器日志：docker logs -f keycloak，或进入容器后检查/opt/keycloak/logs目录下的日志文件

6. 测试PostgreSQL连通性 #

REL 7.9的网络环境可能存在DNS解析或端口访问限制，导致容器无法连接数据库：

• 进入容器后执行psql -h postgres -U xxxxxxxx -d xxxxxxxx，验证数据库连接是否正常
• 若连接失败，将KC_DB_URL中的容器名postgres替换为PostgreSQL容器的实际IP地址，避免DNS解析问题

用户提供的可正常运行Docker Compose配置 #

keycloak:
    image: keycloak-mybuild:20.0.3
    restart: on-failure:5
    container_name: keycloak
    command: start --optimized 
    ports:
      - "8080"
    environment:
      - KC_DB=postgres
      - KC_DB_URL=jdbc:postgresql://postgres:5432/xxxxxxxx
      - KC_DB_USERNAME=xxxxxxxx
      - KC_DB_PASSWORD=xxxxxxxx
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=xxxxxxxx
      - KC_HOSTNAME_STRICT=false
      - KC_HOSTNAME_STRICT_HTTPS=false
      - PROXY_ADDRESS_FORWARDING=true
      - KC_HTTP_RELATIVE_PATH=/auth
      - KC_HTTP_ENABLED=true
      - KC_HTTP_PORT=8080
    depends_on:
      - postgres
    networks:
      - namednetwork

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