stocksoftware/keycloak-sqlserver

docker-keycloak-sqlserver

这是一个扩展Keycloak官方Docker镜像的版本，支持将数据存储到SQL Server数据库中，提供身份认证与授权管理能力。

镜像概述

本镜像基于Keycloak官方镜像扩展，核心功能是提供身份认证、授权服务，并适配SQL Server数据库作为数据存储后端，适用于需要标准身份管理且依赖SQL Server的场景。

核心功能

• 提供Keycloak原生的身份认证、角色管理、权限控制能力
• 支持连接SQL Server数据库存储用户信息、角色数据等
• 可通过环境变量灵活配置数据库连接参数和日志级别

使用场景

适用于企业应用、Web系统或微服务架构中，需要统一身份认证服务且后端数据库采用SQL Server的场景，例如企业内部系统的单点登录、多应用权限统一管理等。

配置说明

创建管理员账户

默认无管理员账户，需手动创建以登录管理控制台：

1. 在运行的容器中执行命令添加用户：

   bash
   docker exec <容器ID> keycloak/bin/add-user-keycloak.sh -u <用户名> -p <密码>
   

2. 重启容器生效：

   bash
   docker restart <容器ID>
   

环境变量配置

启动镜像时可通过以下环境变量配置参数：

• KEYCLOAK_LOGLEVEL：日志级别，可选值如DEBUG（详细日志）
• MSSQL_HOST：SQL Server主机名（必填，无默认）
• MSSQL_PORT：SQL Server端口（可选，默认1433）
• MSSQL_DATABASE：数据库名称（可选，默认keycloak）
• MSSQL_USER：数据库用户名（可选，默认keycloak）
• MSSQL_PASSWORD：数据库密码（可选，默认keycloak）

部署示例

bash
docker run --name keycloak \
  -e KEYCLOAK_LOGLEVEL=DEBUG \
  -e MSSQL_HOST=your-sqlserver-ip \
  -e MSSQL_DATABASE=KEYCLOAK \
  -e MSSQL_USER=keycloak \
  -e MSSQL_PASSWORD=your-secure-password \
  stocksoftware/keycloak-sqlserver