maxird/keycloak

Keycloak Docker镜像文档

镜像概述

Keycloak镜像属于Java子集群，基于java镜像构建，而java镜像又基于centos基础镜像。该镜像提供了开源的身份和访问管理平台，用于实现企业级应用的身份认证、授权和用户管理功能。

核心功能与特性

• 单点登录(SSO)：支持跨多个应用系统的统一身份认证
• 身份验证：提供多种认证方式，包括用户名密码、多因素认证等
• 授权管理：基于角色和权限的访问控制
• 标准协议支持：兼容OAuth 2.0、OpenID Connect、SAML 2.0等标准协议
• 用户管理：提供用户注册、配置文件管理、密码重置等功能
• 集成能力：可与多种应用和服务集成，支持自定义主题和插件

使用场景

• 企业内部多系统统一身份认证
• API访问控制与安全防护
• 第三方应用授权集成
• 云服务和微服务架构中的身份管理
• 需要集中式用户管理和权限控制的场景

使用方法

基本运行命令

bash
docker run -d -p 8080:8080 \
  -e KEYCLOAK_USER=admin \
  -e KEYCLOAK_PASSWORD=admin123 \
  --name keycloak \
  keycloak

Docker Compose配置示例

yaml
version: '3'
services:
  keycloak:
    image: keycloak
    ports:
      - "8080:8080"
    environment:
      - KEYCLOAK_USER=admin
      - KEYCLOAK_PASSWORD=admin123
      - DB_VENDOR=H2
    volumes:
      - keycloak_data:/opt/jboss/keycloak/standalone/data

volumes:
  keycloak_data:

主要环境变量配置

持久化数据

为避免容器重启后数据丢失，建议挂载数据卷：

bash
docker run -d -p 8080:8080 \
  -e KEYCLOAK_USER=admin \
  -e KEYCLOAK_PASSWORD=admin123 \
  -v keycloak_data:/opt/jboss/keycloak/standalone/data \
  --name keycloak \
  keycloak

镜像层级关系

Keycloak镜像位于Java子集群，其基础镜像关系如下： centos → java → keycloak