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

Keycloak with nginx-lookup 镜像文档

镜像概述

本镜像基于基础版Keycloak构建，额外集成了nginx-lookup功能。Keycloak是一款开源的身份和访问管理解决方案，支持OAuth 2.0、OpenID Connect等标准协议，用于实现用户认证、授权管理和单点登录（SSO）。本镜像在保留Keycloak核心功能的基础上，增加了与nginx集成的查找机制，适用于需要通过nginx进行反向代理或请求处理时的用户信息查找场景。

核心功能与特性

基础Keycloak功能

• 用户认证与授权管理
• 支持OAuth 2.0、OpenID Connect、SAML 2.0等标准协议
• 角色与权限管理
• 单点登录（SSO）支持
• 用户联邦（如LDAP、Active Directory集成）

新增nginx-lookup功能

• 集成nginx相关的用户信息查找机制
• 支持在nginx反向代理场景下的用户身份验证信息传递
• 增强与nginx服务的联动能力，优化请求处理流程

使用场景

• 企业内部系统的身份认证与授权管理
• 需要通过nginx反向代理实现用户身份验证的场景
• 多系统集成单点登录（SSO）的环境
• 需在nginx层进行用户信息查找和权限校验的业务场景

使用方法

基本运行命令

bash
docker run -d \
  -p 8080:8080 \
  -e KEYCLOAK_ADMIN=admin \
  -e KEYCLOAK_ADMIN_PASSWORD=admin123 \
  --name keycloak-nginx-lookup \
  [镜像名称]:[标签]

关键配置参数

环境变量

• KEYCLOAK_ADMIN：Keycloak管理员用户名，默认值可根据镜像配置调整
• KEYCLOAK_ADMIN_PASSWORD：Keycloak管理员密码，建议部署时修改为安全密码
• KC_HOSTNAME：指定Keycloak的访问主机名，如keycloak.example.com
• KC_HTTP_PORT：HTTP服务端口，默认8080
• KC_HTTPS_PORT：HTTPS服务端口，如需启用HTTPS可配置

端口映射

• 8080：Keycloak默认HTTP端口，用于Web管理界面和API访问

docker-compose配置示例

yaml
version: '3.8'
services:
  keycloak:
    image: [镜像名称]:[标签]
    ports:
      - "8080:8080"
    environment:
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=secure_password
      - KC_HOSTNAME=keycloak.example.com
    volumes:
      - keycloak_data:/opt/keycloak/data
    restart: unless-stopped

volumes:
  keycloak_data:

注意事项

• 生产环境中建议启用HTTPS，可通过配置KC_HTTPS_PORT及证书挂载实现
• 管理员密码需设置高强度密码，避免使用默认值
• 数据持久化建议通过挂载卷实现，防止容器重启后数据丢失
• nginx-lookup功能的具体使用方式需参考镜像内置文档或相关集成指南