davidfrickert/keycloak

Keycloak 镜像文档

镜像概述

本镜像基于 bitnami/keycloak 基础镜像构建，未添加任何额外补丁，直接通过源码 Dockerfile 编译构建。Keycloak 是一款开源的身份和访问管理解决方案，提供单点登录、OAuth 2.0、OpenID Connect 等功能，适用于企业级应用的身份认证与授权管理。

核心功能与特性

• 基于官方基础：以 bitnami/keycloak 为基础镜像，确保兼容性和稳定性
• 无额外补丁：保持原始构建流程，未修改核心代码，降低定制化风险
• 源码构建：通过 Dockerfile 从源码直接构建，确保构建过程透明可追溯
• 完整功能支持：继承 Keycloak 核心功能，包括用户管理、角色权限、单点登录、身份代理等

使用场景

• 企业内部应用的统一身份认证与授权
• 多系统集成单点登录（SSO）
• 第三方应用 OAuth2/OIDC 认证集成
• 多租户身份管理系统搭建

使用方法

基本运行

通过以下命令启动 Keycloak 容器：

bash
docker run -d \
  -p 8080:8080 \
  --name keycloak \
  docker.xuanyuan.run/your-image-name:latest

访问 http://localhost:8080 即可打开 Keycloak 管理界面。

环境变量配置

可通过环境变量配置 Keycloak 核心参数，常用配置如下：

示例（使用 PostgreSQL 数据库）：

bash
docker run -d \
  -p 8080:8080 \
  -e KEYCLOAK_ADMIN=admin \
  -e KEYCLOAK_ADMIN_PASSWORD=password \
  -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 \
  docker.xuanyuan.run/your-image-name:latest

Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  keycloak:
    image: docker.xuanyuan.run/your-image-name:latest
    ports:
      - "8080:8080"
    environment:
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=password
      - DB_VENDOR=postgres
      - DB_ADDR=postgres
      - DB_PORT=5432
      - DB_DATABASE=keycloak
      - DB_USER=keycloak
      - DB_PASSWORD=keycloak
    depends_on:
      - postgres

  postgres:
    image: docker.xuanyuan.run/postgres:14
    environment:
      - POSTGRES_DB=keycloak
      - POSTGRES_USER=keycloak
      - POSTGRES_PASSWORD=keycloak
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

启动服务：

bash
docker-compose up -d

注意事项

• 生产环境中建议使用外部数据库（如 PostgreSQL、MySQL）替代默认的 H2 内存数据库
• 应通过环境变量设置强密码，避免使用默认凭证
• 建议配置 HTTPS，可通过反向代理（如 Nginx）实现 SSL 终止
• 容器数据持久化需挂载相应目录，避免数据丢失