icolabora/keycloak

iColabora Keycloak 镜像文档

镜像概述

本镜像直接基于https://hub.docker.com/r/jboss/keycloak/%E6%9E%84%E5%BB%BA%EF%BC%8C%E4%BB%85%E6%B7%BB%E5%8A%A0%E7%BB%84%E7%BB%87%E5%86%85%E9%83%A8%E9%9C%80%E8%A6%81%E7%9A%84%E5%8D%B3%E6%97%B6bug%E4%BF%AE%E5%A4%8D%EF%BC%8C%E7%9B%B4%E8%87%B3%E4%B8%8A%E6%B8%B8%E5%AE%98%E6%96%B9%E4%BB%93%E5%BA%93%E6%8E%A5%E5%8F%97%E7%9B%B8%E5%85%B3%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%E3%80%82%E4%B8%BB%E8%A6%81%E7%94%A8%E9%80%94%E6%98%AF%E4%B8%BA%E7%BB%84%E7%BB%87%E6%8F%90%E4%BE%9B%E5%8C%85%E5%90%AB%E5%85%B3%E9%94%AE%E4%BF%AE%E5%A4%8D%E7%9A%84Keycloak%E6%9C%8D%E5%8A%A1%EF%BC%8C%E7%A1%AE%E4%BF%9D%E5%9C%A8%E5%AE%98%E6%96%B9%E4%BF%AE%E5%A4%8D%E5%8F%91%E5%B8%83%E5%89%8D%E5%8F%AF%E4%BD%BF%E7%94%A8%E7%A8%B3%E5%AE%9A%E7%89%88%E6%9C%AC%E3%80%82

核心功能和特性

• 基于官方镜像：完全继承jboss/keycloak官方镜像的所有功能和特性，保持兼容性
• 即时bug修复：仅包含组织所需的必要bug修复，无额外功能修改，最小化与官方版本的差异
• 标签一致性：使用与jboss/keycloak官方镜像相同的标签体系，便于版本对应和迁移

使用场景和适用范围

适用于组织内部需要使用Keycloak服务，但官方镜像存在未修复的关键bug，且上游拉取请求尚未被接受的场景。特别适合需要快速获取修复版本，同时希望保持与官方版本兼容性的用户。

使用方法和配置说明

镜像拉取

bash
docker pull icolabora/keycloak:<tag>

其中 <tag> 与 jboss/keycloak 官方镜像标签一致（如 18.0.0、latest 等）。

容器运行示例

基本运行命令（同官方镜像使用方式）：

bash
docker run -d -p 8080:8080 icolabora/keycloak:<tag>

带环境变量配置示例（管理员账号设置）：

bash
docker run -d \
  -p 8080:8080 \
  -e KEYCLOAK_USER=admin \
  -e KEYCLOAK_PASSWORD=admin123 \
  icolabora/keycloak:<tag>

配置说明

本镜像未修改Keycloak的核心配置机制，所有配置方式与jboss/keycloak官方镜像一致。可参考官方文档进行环境变量、配置文件等设置。

源代码与Dockerfile

• Keycloak源代码：https://github.com/iColabora/keycloak
• Dockerfile：https://github.com/iColabora/keycloak-dockerfiles/tree/master/server