dimdockerhub/keycloak

Keycloak HA定制镜像

镜像概述

本镜像基于JBoss官方Keycloak镜像构建，专为高可用(HA)部署场景定制。通过优化配置参数和集群支持，确保在多节点环境下提供稳定的身份认证、授权服务，适用于对系统可用性有高要求的企业级应用。

核心功能与特性

• 基于官方镜像：保留JBoss Keycloak官方镜像的全部核心功能，确保兼容性和安全性
• HA配置优化：预配置高可用相关参数，支持集群模式下的会话共享与数据同步
• 灵活部署：支持多种数据库后端（如PostgreSQL、MySQL等）及缓存配置（如Infinispan）
• 易于扩展：可通过环境变量快速配置集群节点信息，支持动态扩缩容

使用场景

• 企业级身份认证与授权服务
• 多节点集群部署的Keycloak实例
• 对系统可用性要求高的生产环境
• 需要跨节点会话共享的分布式应用

使用方法与配置说明

环境变量配置

Docker Run示例

bash
docker run -d \
  -e DB_VENDOR=POSTGRES \
  -e DB_ADDR=postgres-host \
  -e DB_PORT=5432 \
  -e DB_DATABASE=keycloak \
  -e DB_USER=keycloak-user \
  -e DB_PASSWORD=secure-password \
  -e CACHE_STACK=kubernetes \
  -e JGROUPS_DISCOVERY_PROTOCOL=dns.DNS_PING \
  -e JGROUPS_DISCOVERY_PROPERTIES=dns_query=keycloak-headless.default.svc.cluster.local \
  -p 8080:8080 \
  --name keycloak-ha-node1 \
  [镜像名称]:[版本]

Docker Compose示例

yaml
version: '3.8'
services:
  keycloak-node1:
    image: [镜像名称]:[版本]
    environment:
      - DB_VENDOR=POSTGRES
      - DB_ADDR=postgres
      - DB_PORT=5432
      - DB_DATABASE=keycloak
      - DB_USER=keycloak
      - DB_PASSWORD=keycloak
      - CACHE_STACK=kubernetes
      - JGROUPS_DISCOVERY_PROTOCOL=dns.DNS_PING
      - JGROUPS_DISCOVERY_PROPERTIES=dns_query=keycloak-headless
    ports:
      - "8080:8080"
    depends_on:
      - postgres

  keycloak-node2:
    image: [镜像名称]:[版本]
    environment:
      - DB_VENDOR=POSTGRES
      - DB_ADDR=postgres
      - DB_PORT=5432
      - DB_DATABASE=keycloak
      - DB_USER=keycloak
      - DB_PASSWORD=keycloak
      - CACHE_STACK=kubernetes
      - JGROUPS_DISCOVERY_PROTOCOL=dns.DNS_PING
      - JGROUPS_DISCOVERY_PROPERTIES=dns_query=keycloak-headless
    ports:
      - "8081:8080"
    depends_on:
      - postgres

  postgres:
    image: postgres:13
    environment:
      - POSTGRES_DB=keycloak
      - POSTGRES_USER=keycloak
      - POSTGRES_PASSWORD=keycloak
    volumes:
      - postgres-data:/var/lib/postgresql/data

  keycloak-headless:
    image: busybox
    command: top

volumes:
  postgres-data:

注意事项

• 确保所有集群节点可通过网络相互通信
• 数据库需独立部署并保证高可用（如主从复制）
• 生产环境建议配置HTTPS（通过KEYCLOAK_HTTPS_PORT等环境变量）
• 集群规模扩展时，需确保缓存配置与节点数量匹配