thetadev256/keycloak

thetadev256/keycloak

镜像概述和主要用途

thetadev256/keycloak是一个优化的Keycloak镜像，基于官方Keycloak镜像构建，添加了PostgreSQL数据库支持和持久化缓存功能。该镜像确保在容器重启后会话数据不会丢失，适用于需要稳定身份认证和授权服务的场景。

原始镜像来源：[***]

核心功能和特性

• PostgreSQL支持：原生集成PostgreSQL数据库，可配置外部PostgreSQL实例存储数据
• 持久化缓存：通过卷挂载实现缓存持久化，确保重启后会话数据保留
• 基于官方镜像优化：继承官方Keycloak镜像的所有功能，并针对生产环境进行优化
• 灵活配置：支持通过环境变量进行全面配置，适应不同部署需求

使用场景和适用范围

• 需要稳定身份认证和授权的企业级应用
• 要求会话数据在服务重启后不丢失的场景
• 采用PostgreSQL作为数据库的部署环境
• 需通过反向代理（如Traefik）暴露服务的场景

使用方法和配置说明

Docker Compose示例（Traefik反向代理）

以下示例展示了如何在Traefik反向代理后部署thetadev256/keycloak：

yaml
version: "3"
services:
  keycloak:
    image: thetadev256/keycloak:latest
    restart: unless-stopped
    volumes:
      - keycloak-cache:/opt/keycloak/cache  # 持久化缓存卷
    networks:
      - proxy  # 与Traefik共享网络
    environment:
      - KC_HOSTNAME=auth.example.com  # Keycloak主机名
      - KC_DB=postgres  # 使用PostgreSQL数据库
      - KC_DB_URL=jdbc:postgresql://postgres/keycloak  # PostgreSQL连接URL
      - KC_DB_USERNAME=postgres  # PostgreSQL用户名
      - KC_DB_PASSWORD=secret  # PostgreSQL密码
      - KC_HTTP_ENABLED=true  # 启用HTTP（由反向代理处理HTTPS）
      - KC_PROXY=edge  # 配置为边缘代理模式
      - KEYCLOAK_ADMIN=admin  # Keycloak管理员用户名
      - KEYCLOAK_ADMIN_PASSWORD=change_me  # Keycloak管理员密码
    labels:
      - "traefik.enable=true"  # 启用Traefik代理
      - "traefik.docker.network=proxy"  # 指定Traefik网络
      - "traefik.http.routers.keycloak.entrypoints=websecure"  # 使用HTTPS入口点
      - "traefik.http.routers.keycloak.rule=Host(`auth.example.com`)"  # 域名规则
      - "traefik.http.services.keycloak.loadbalancer.server.port=8080"  # 容器内部端口
    command: ["start"]  # 启动Keycloak服务

networks:
  proxy:
    external: true  # 使用外部网络

volumes:
  keycloak-cache:  # 定义持久化缓存卷

环境变量配置说明

原始文档参考

• 配置选项：[***]
• Dockerfile相关说明：[***]