owncloudops/keycloak Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

keycloak

![构建状态]([] ![Docker Hub]([] ![Quay.io]([***]

Keycloak的自定义容器镜像。有关优化容器镜像的更多详细信息，请参阅Keycloak 文档。嵌入式健康检查脚本默认禁用，且仅在HTTP端口上工作。

镜像概述和主要用途

本镜像基于Keycloak官方容器镜像优化构建，提供安全的身份管理和访问控制功能。适用于需要集中式身份认证、授权管理的应用场景，支持多租户、单点登录(SSO)等企业级功能，并集成自定义认证限制提供者增强安全性。

核心功能和特性

端口

• 8080: HTTP端口
• 8443: HTTPS端口

构建环境变量

Shell
# 数据库类型配置
KC_DB=mariadb

# 启用健康检查和指标监控
KC_HEALTH_ENABLED=true
KC_METRICS_ENABLED=true

# HTTP相对路径，若修改此值需同步调整健康检查脚本
KC_HTTP_RELATIVE_PATH=/auth

# HTTPS密钥存储文件路径，若设置且容器启动时文件不存在，将自动生成新密钥库
KC_HTTPS_KEY_STORE_FILE=

# Infinispan缓存配置，注意：默认本地缓存配置(cache-ispn-local.xml)仅适用于单节点部署
KC_CACHE=ispn
KC_CACHE_CONFIG_FILE=cache-ispn-local.xml

# 事务配置
KC_TRANSACTION_XA_ENABLED=true
QUARKUS_TRANSACTION_MANAGER_ENABLE_RECOVERY=true

自定义提供者

• sventorben/keycloak-restrict-client-auth: 提供客户端认证限制功能，增强客户端访问控制安全性

使用场景和适用范围

• 企业级应用的集中式身份认证与授权管理
• 需要实现单点登录(SSO)的多应用系统
• 对客户端认证有严格限制要求的安全场景
• 单节点部署的Keycloak服务（默认缓存配置）

使用方法和配置说明

构建镜像

Shell
docker build -f Dockerfile -t keycloak:latest .

运行容器示例

Shell
docker run -d \
  -p 8080:8080 \
  -p 8443:8443 \
  -e KC_DB=postgres \
  -e KC_DB_URL=jdbc:postgresql://db:5432/keycloak \
  -e KC_DB_USERNAME=keycloak \
  -e KC_DB_PASSWORD=secret \
  -e KC_HTTP_RELATIVE_PATH=/auth \
  --name keycloak \
  owncloudops/keycloak:latest

配置说明

核心配置参数

注意事项

• 修改KC_HTTP_RELATIVE_PATH后，需同步调整健康检查脚本
• 默认缓存配置(cache-ispn-local.xml)仅适用于单节点部署，集群部署需更换为分布式缓存配置
• 启用HTTPS时，若KC_HTTPS_KEY_STORE_FILE指定的文件不存在，容器启动时将自动生成自签名证书

许可证

本项目采用Apache 2.0许可证 - 详见LICENSE文件。