devsu/keycloak-mysql-ha

Keycloak MySQL高可用镜像

镜像概述

本镜像基于Keycloak构建，配置了高可用（HA）模式，使用MySQL作为后端数据库，并通过JDBC_PING实现集群节点发现，适用于需要稳定身份认证与授权服务的生产环境。

核心功能

1. 高可用集群：通过JDBC_PING机制自动发现集群节点，保障服务连续性。
2. MySQL集成：稳定连接MySQL数据库存储用户数据与配置信息。
3. 标准身份协议支持：兼容OAuth2、OpenID Connect等主流身份协议，提供用户管理、角色权限控制等核心功能。

使用场景

• 企业级应用的统一身份认证系统。
• 分布式服务架构中的高可用认证组件。
• 多租户系统的身份管理解决方案。

配置说明

主要环境变量配置：

• DB_VENDOR：数据库类型（固定为MYSQL）。
• DB_ADDR：MySQL数据库地址。
• DB_DATABASE：数据库名称。
• DB_USER：数据库用户名。
• DB_PASSWORD：数据库密码。
• JGROUPS_DISCOVERY_PROTOCOL：集群发现协议（固定为JDBC_PING）。

部署示例

Docker Run命令

bash
docker run -d \
  -e DB_VENDOR=MYSQL \
  -e DB_ADDR=mysql-host \
  -e DB_DATABASE=keycloak \
  -e DB_USER=keycloak \
  -e DB_PASSWORD=your-password \
  -e JGROUPS_DISCOVERY_PROTOCOL=JDBC_PING \
  -p 8080:8080 \
  devsu/keycloak-mysql-ha

Docker Compose示例

yaml
version: '3'
services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root-pass
      MYSQL_DATABASE: keycloak
      MYSQL_USER: keycloak
      MYSQL_PASSWORD: your-pass
    volumes:
      - mysql-data:/var/lib/mysql
  keycloak:
    image: devsu/keycloak-mysql-ha
    environment:
      DB_VENDOR: MYSQL
      DB_ADDR: mysql
      DB_DATABASE: keycloak
      DB_USER: keycloak
      DB_PASSWORD: your-pass
      JGROUPS_DISCOVERY_PROTOCOL: JDBC_PING
    ports:
      - "8080:8080"
    depends_on:
      - mysql
volumes:
  mysql-data: