netoralves/keycloak

Keycloak Server (SQL Server 2018支持版) Docker镜像文档

镜像概述

本镜像基于Keycloak Server构建，专门优化了与外部SQL Server 2018数据库的连接支持。Keycloak是一款开源的身份和访问管理解决方案，提供用户认证、授权、单点登录(SSO)等功能，适用于企业级应用的身份管理场景。本镜像通过预配置的数据库驱动和连接参数，简化了Keycloak与SQL Server 2018的集成过程。

核心功能与特性

• 身份管理：支持用户注册、登录、角色分配及权限管理
• 单点登录：支持多种协议（OAuth 2.0、OpenID Connect、SAML 2.0）
• SQL Server 2018集成：预配置SQL Server驱动，支持外部数据库连接
• 可扩展性：支持集群部署和水平扩展
• 安全特性：包含内置的安全策略、密码策略及多因素认证支持

使用场景

• 企业内部系统的统一身份认证平台
• 需要与SQL Server 2018数据库集成的身份管理系统
• 多应用环境下的单点登录解决方案
• 需满足高可用性要求的身份服务部署

使用方法

前提条件

• 已部署SQL Server 2018数据库实例
• 已创建Keycloak专用数据库（如keycloak_db）
• 已配置数据库用户权限（需具备数据库读写权限）

基本部署（docker run）

bash
docker run -d \
  --name keycloak-sqlserver \
  -p 8080:8080 \
  -e KEYCLOAK_ADMIN=admin \
  -e KEYCLOAK_ADMIN_PASSWORD=admin123 \
  -e DB_VENDOR=SQLSERVER \
  -e DB_ADDR=sqlserver-host \
  -e DB_PORT=1433 \
  -e DB_DATABASE=keycloak_db \
  -e DB_USER=keycloak_user \
  -e DB_PASSWORD=keycloak_pass \
  your-image-name:latest start-dev

Docker Compose部署

yaml
version: '3.8'
services:
  keycloak:
    image: your-image-name:latest
    container_name: keycloak-sqlserver
    ports:
      - "8080:8080"
    environment:
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=admin123
      - DB_VENDOR=SQLSERVER
      - DB_ADDR=sqlserver  # 对应SQL Server服务名
      - DB_PORT=1433
      - DB_DATABASE=keycloak_db
      - DB_USER=keycloak_user
      - DB_PASSWORD=keycloak_pass
    depends_on:
      - sqlserver
    restart: unless-stopped

  sqlserver:
    image: mcr.microsoft.com/mssql/server:2019-latest
    container_name: sqlserver-2018
    environment:
      - ACCEPT_EULA=Y
      - SA_PASSWORD=StrongPassw0rd!
      - MSSQL_PID=Developer
    ports:
      - "1433:1433"
    volumes:
      - sqlserver-data:/var/opt/mssql
    restart: unless-stopped

volumes:
  sqlserver-data:

配置参数说明

核心环境变量

高级配置（可选）

访问与验证

1. 启动容器后，通过http://localhost:8080访问Keycloak管理界面
2. 使用配置的KEYCLOAK_ADMIN和KEYCLOAK_ADMIN_PASSWORD登录
3. 在管理界面中，通过Realm Settings > Storage确认数据库连接状态

注意事项

• SQL Server数据库需启用TCP/IP连接（默认端口1433）
• 首次启动时，Keycloak会自动创建所需数据库表结构
• 生产环境建议使用start模式（而非start-dev）并配置HTTPS
• 高可用部署需配置共享数据库和缓存（如Infinispan）