anduin/keycloak

Anduin Transaction Inc Keycloak Docker镜像文档

镜像概述

本镜像为Anduin Transaction Inc提供的Keycloak Docker镜像，基于开源身份和访问管理解决方案Keycloak构建，旨在为应用程序和服务提供安全的用户认证、授权及单点登录（SSO）功能。

核心功能与特性

• 身份认证：支持多种认证方式，包括用户名密码、OAuth 2.0、OpenID Connect等
• 授权管理：细粒度的权限控制，支持角色基础访问控制（RBAC）
• 单点登录：实现多应用间的无缝登录体验，减少用户重复认证
• 多租户支持：支持多个独立的领域（Realm），满足不同组织或项目的隔离需求
• 用户管理：提供用户注册、配置文件管理、密码重置等功能
• 扩展性：支持自定义认证流程、主题定制和插件扩展

使用场景与适用范围

• 企业内部应用系统的统一身份认证
• Web应用、移动应用的用户登录与权限控制
• API服务的访问授权管理
• 需要实现单点登录的多系统集成场景
• 对用户身份安全有较高要求的业务系统

使用方法与配置说明

基本运行

使用以下命令启动Keycloak容器：

bash
docker run -d -p 8080:8080 --name keycloak anduin/keycloak

环境变量配置

可通过环境变量自定义Keycloak配置，常用参数如下：

示例：使用PostgreSQL数据库

bash
docker run -d -p 8080:8080 \
  -e KEYCLOAK_ADMIN=admin \
  -e KEYCLOAK_ADMIN_PASSWORD=admin123 \
  -e DB_VENDOR=postgres \
  -e DB_ADDR=postgres-host \
  -e DB_PORT=5432 \
  -e DB_DATABASE=keycloak \
  -e DB_USER=keycloakuser \
  -e DB_PASSWORD=keycloakpass \
  --name keycloak anduin/keycloak

Docker Compose示例

yaml
version: '3.8'
services:
  keycloak:
    image: anduin/keycloak
    ports:
      - "8080:8080"
    environment:
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=admin123
      - DB_VENDOR=postgres
      - DB_ADDR=postgres
      - DB_PORT=5432
      - DB_DATABASE=keycloak
      - DB_USER=keycloakuser
      - DB_PASSWORD=keycloakpass
    depends_on:
      - postgres

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

volumes:
  postgres-data:

访问管理界面

容器启动后，通过以下地址访问Keycloak管理界面：
http://localhost:8080/admin
使用配置的管理员用户名和密码登录。