steveviso/keycloak-viso

镜像概述

该镜像是jboss/Keycloak仓库的克隆版本，在保留Keycloak原有功能的基础上，新增了对arm64和amd64两种架构的支持。Keycloak是一款开源的身份和访问管理解决方案，提供单点登录、OAuth2.0、OpenID Connect等功能，适用于保护应用程序和服务的访问安全。本镜像扩展了架构兼容性，可在不同硬件架构的环境中部署使用。

核心功能和特性

• 与jboss/Keycloak兼容：完全克隆原仓库功能，支持Keycloak的所有核心特性，包括用户认证、授权管理、角色分配、会话管理等
• 多架构支持：新增对arm64和amd64架构的支持，可在x86_64服务器、ARM设备（如树莓派、ARM服务器）等不同硬件平台上运行
• 标准接口：保持与Keycloak官方镜像一致的API和配置方式，便于现有Keycloak用户无缝迁移
• 开源基础：基于Keycloak开源项目构建，持续同步上游更新，确保功能完整性和安全性

使用场景和适用范围

• 跨架构部署环境：适用于同时使用amd64（x86_64）和arm64架构服务器的企业，实现统一的身份认证服务部署
• 混合云架构：在混合云环境中，可在不同架构的云服务器（如AWS Graviton2/3 (arm64)、传统x86云服务器）上部署相同的Keycloak实例
• 开发测试环境：开发人员可在本地ARM设备（如M1/M2 Mac、ARM开发板）和x86设备上一致地测试Keycloak集成功能
• 边缘计算场景：在边缘计算环境中，可部署于arm64架构的边缘设备，提供本地化的身份认证服务

使用方法和配置说明

基本部署（docker run）

通过以下命令可快速启动镜像，支持amd64和arm64架构自动适配：

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

参数说明：

• -p 8080:8080：映射容器8080端口到主机，用于访问Keycloak管理界面和API
• -e KEYCLOAK_ADMIN：Keycloak管理员用户名
• -e KEYCLOAK_ADMIN_PASSWORD：Keycloak管理员密码
• --name：容器名称，可自定义

Docker Compose配置

创建docker-compose.yml文件，配置如下：

yaml
version: '3.8'
services:
  keycloak:
    image: [镜像名称]:[标签]
    ports:
      - "8080:8080"
    environment:
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=admin123
      - KC_DB=postgres  # 可选，指定数据库类型，如postgres、mysql等
      - KC_DB_URL=jdbc:postgresql://postgres:5432/keycloak  # 数据库连接URL
      - KC_DB_USERNAME=keycloak
      - KC_DB_PASSWORD=keycloak
    depends_on:
      - postgres  # 若使用外部数据库，需配置对应数据库服务

  postgres:
    image: postgres:14
    environment:
      - POSTGRES_DB=keycloak
      - POSTGRES_USER=keycloak
      - POSTGRES_PASSWORD=keycloak
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

访问管理界面

部署完成后，通过http://localhost:8080/admin访问Keycloak管理界面，使用配置的管理员用户名和密码登录，进行 realm 创建、用户管理、客户端配置等操作。

常用环境变量