epiphanyplatform/keycloak

镜像概述和主要用途

本镜像基于Keycloak官方容器源码构建，是一款支持多架构的Docker镜像，同时兼容arm64和x86_64架构，旨在替代官方的jboss/keycloak:x.x.x镜像，为跨架构环境提供一致的Keycloak身份认证服务部署能力。

核心功能和特性

• 多架构支持：同时支持linux/amd64（x86_64）和linux/arm64架构，满足不同硬件平台的部署需求
• 兼容性：与官方jboss/keycloak:x.x.x镜像接口完全兼容，可直接替换使用，无需修改现有配置
• 可重现构建：提供完整透明的构建步骤，确保镜像构建过程可复现，保障镜像安全性和一致性

使用场景和适用范围

适用于需要在混合架构环境（如ARM架构服务器与x86_64服务器并存）中部署Keycloak身份认证服务的场景，尤其适合云环境、边缘计算节点及多架构服务器集群等跨平台部署需求。

使用方法和配置说明

构建镜像

按照以下步骤构建多架构Keycloak镜像：

1. 克隆官方仓库：

   bash
   git clone https://github.com/keycloak/keycloak-containers/
   

2. 检出指定版本标签（将x.x.x替换为具体版本号）：

   bash
   git checkout x.x.x
   

3. 进入服务器目录：

   bash
   cd keycloak-containers/server
   

4. 创建Docker Buildx构建器：

   bash
   docker buildx create --name mybuilder
   

5. 切换到创建的构建器：

   bash
   docker buildx use mybuilder
   

6. 检查构建器支持的架构（确保包含linux/amd64和linux/arm64）：

   bash
   docker buildx inspect --bootstrap
   

7. 构建并推送多架构镜像（将x.x.x替换为版本号，epiphanyplatform/keycloak替换为自定义镜像仓库）：

   bash
   docker buildx build --platform linux/amd64,linux/arm64 -t epiphanyplatform/keycloak:x.x.x --push .
   

运行镜像

基本运行命令

bash
docker run -d -p 8080:8080 epiphanyplatform/keycloak:x.x.x

指定管理员账户运行

bash
docker run -d -p 8080:8080 \
  -e KEYCLOAK_USER=admin \
  -e KEYCLOAK_PASSWORD=password \
  epiphanyplatform/keycloak:x.x.x

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  keycloak:
    image: epiphanyplatform/keycloak:x.x.x
    ports:
      - "8080:8080"
    environment:
      - KEYCLOAK_USER=admin
      - KEYCLOAK_PASSWORD=password
      - DB_VENDOR=h2  # 使用内置H2数据库，生产环境建议使用postgres或mysql
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

常用配置参数