lapierre/keycloak

Keycloak Docker镜像文档

镜像概述和主要用途

Keycloak是一款高性能的Java身份与访问管理解决方案，本Docker镜像基于Alpine构建，旨在帮助开发者以最小的 effort 为应用添加认证层。该镜像经过安全补丁处理，确保包含最新的bug修复和功能特性，已在多个生产项目及国际公司中验证使用。

核心功能和特性

• Alpine基础与安全补丁：基于Alpine Linux构建，体积小且包含安全补丁，提升运行环境安全性。
• 及时更新：快速同步Keycloak的最新bug修复和功能特性，确保用户能及时使用最新版本。
• 生产级验证：已在多个生产项目和国际公司中实际应用并验证，稳定性和可靠性有保障。

使用场景和适用范围

• 开发者需要为应用快速集成身份认证和访问控制功能时。
• 需在生产环境中部署高性能、安全可靠的身份管理服务时。
• 对镜像体积有要求，需要轻量级运行环境的场景。

使用方法和配置说明

基本运行

通过以下命令启动Keycloak容器：

bash
docker run -d -p 8080:8080 --name keycloak whindes/openjdk-alpine-keycloak

容器启动后，可通过 http://localhost:8080 访问Keycloak管理界面。

环境变量配置

可通过环境变量自定义Keycloak配置，常用变量包括：

• KEYCLOAK_ADMIN：管理员用户名，默认值需参考镜像具体版本说明。
• KEYCLOAK_ADMIN_PASSWORD：管理员密码，建议启动时显式设置。
• DB_VENDOR：数据库类型，如h2（默认，仅用于开发）、postgres、mysql等。

示例（使用PostgreSQL数据库）：

bash
docker run -d \
  -p 8080:8080 \
  -e KEYCLOAK_ADMIN=admin \
  -e KEYCLOAK_ADMIN_PASSWORD=secret \
  -e DB_VENDOR=postgres \
  -e DB_ADDR=postgres-host \
  -e DB_PORT=5432 \
  -e DB_DATABASE=keycloak \
  -e DB_USER=keycloak \
  -e DB_PASSWORD=keycloak \
  --name keycloak \
  whindes/openjdk-alpine-keycloak

Docker Compose示例

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  keycloak:
    image: whindes/openjdk-alpine-keycloak
    ports:
      - "8080:8080"
    environment:
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=secret
      - DB_VENDOR=h2
    restart: unless-stopped

执行 docker-compose up -d 启动服务。

注意事项

• 生产环境中建议使用外部数据库（如PostgreSQL、MySQL）替代默认的H2数据库。
• 根据实际需求调整端口映射和资源限制，确保服务性能。
• 定期更新镜像以获取最新安全补丁和功能。

更多详细配置可参考项目GitHub仓库：https://github.com/whindes/openjdk-alpine-keycloak