schreiberdev/keycloak

在Docker中运行Keycloak

流水线状态

简介

无需阅读https://www.keycloak.org/server/containers即可在Docker容器中运行Keycloak。该镜像使用PostgreSQL作为数据库。请注意，假设Keycloak将运行在某种反向代理之后，例如https://doc.traefik.io/traefik/。

核心功能和特性

• 简化部署：无需手动配置Keycloak和数据库，通过Docker容器化快速部署
• PostgreSQL数据库：使用PostgreSQL作为后端数据库，提供可靠的数据存储
• 反向代理兼容：设计用于在反向代理环境下运行，适合生产环境部署
• 持久化存储：通过卷挂载实现PostgreSQL数据持久化，避免数据丢失

使用场景和适用范围

• 快速搭建Keycloak认证服务的开发/测试环境
• 需要在容器化环境中部署Keycloak的生产场景
• 已配置反向代理（如Traefik、Nginx）的架构中集成Keycloak认证

使用方法和配置说明

环境变量配置

Keycloak服务支持以下环境变量配置：

PostgreSQL服务支持以下环境变量配置：

Docker Compose示例

yaml
version: "3"
services:
  runtime:
    image: docker.xuanyuan.run/schreiberdev/keycloak
    restart: unless-stopped
    depends_on:
      - db  # 依赖PostgreSQL数据库服务
    environment:
      - KC_ADMIN=kcadmin  # Keycloak管理员用户名
      - KC_ADMIN_PASSWORD=<CHANGE_ME>  # 替换为安全的管理员密码
      - KC_HOSTNAME=<CHANGE_ME>  # 替换为实际访问域名
      - KC_DB_URL=jdbc:postgresql://db:5432/keycloak  # 数据库连接URL
      - KC_DB_USERNAME=keycloak  # 数据库用户名
      - KC_DB_PASSWORD=keycloak  # 数据库密码
  db:
    image: docker.xuanyuan.run/postgres  # 使用官方PostgreSQL镜像
    environment:
      - POSTGRES_PASSWORD=keycloak  # 数据库密码
      - POSTGRES_USER=keycloak  # 数据库用户名
      - POSTGRES_DB=keycloak  # 数据库名称
    restart: unless-stopped  # 除非手动停止，否则自动重启
    volumes:
      - db:/var/lib/postgresql/data  # 挂载卷以持久化数据库数据
volumes:
  db:  # 定义持久化卷

部署步骤

1. 替换docker-compose.yml中的<CHANGE_ME>占位符为实际值（管理员密码和访问域名）
2. 执行docker-compose up -d启动服务
3. 服务启动后，通过https://<KC_HOSTNAME>/admin访问Keycloak管理界面，使用配置的管理员账号登录