Keycloak (由Elestio验证和打包)

!Elestio

![]([] ![GitHub]([] ![博客]([]

镜像概述和主要用途

Keycloak 是一款开源软件产品，旨在为现代应用程序和服务提供单点登录功能以及身份和访问管理解决方案。

如果您需要自动化备份、带SSL终端的反向代理、防火墙、自动化操作系统和软件更新，以及由Linux专家和开源爱好者组成的团队确保您的服务始终安全且正常运行，可在elest.io上部署完全托管的Keycloak。

核心功能和特性

为什么选择Elestio镜像?

• Elestio与原始源代码的更新保持同步，并通过自动化流程快速发布此镜像的新版本
• Elestio镜像提供对最新错误修复和功能的及时访问
• 我们的团队执行质量控制检查，确保我们发布的产品符合高标准

使用场景和适用范围

Keycloak适用于需要以下功能的现代应用程序和服务：

• 单点登录(SSO)实现
• 用户身份管理
• 访问权限控制
• 安全认证机制
• OAuth 2.0、OpenID Connect等标准协议支持

使用方法和配置说明

Docker Compose配置

以下是帮助您开始创建容器的示例配置片段：

version: "3.3"
services:
    postgresql:
        image: elestio/postgres:15
        restart: always
        env_file:
            - .env
        ports:
            - 172.17.0.1:5672:5432
        volumes:
            - ./postgres_data:/var/lib/postgresql/data
        networks:
            - keycloak-network

    keycloak:
        user: 0:0
        image: elestio/keycloak:${SOFTWARE_VERSION_TAG}
        restart: always
        entrypoint: "/opt/keycloak/bin/kc.sh start --hostname-strict=false --http-enabled=true --proxy-headers=xforwarded"
        volumes:
            - ./providers:/opt/keycloak/providers
            - ./themes:/opt/keycloak/themes
        env_file:
            - .env
        ports:
            - "172.17.0.1:8080:8080"
        environment:
            - KEYCLOAK_LOGLEVEL=ALL
            - QUARKUS_TRANSACTION_MANAGER_ENABLE_RECOVERY=true
            - PROXY_ADDRESS_FORWARDING=true
            - KEYCLOAK_HTTP_ENABLED=true
            - KEYCLOAK_ADMIN=$KEYCLOAK_ADMIN_USER
            - KEYCLOAK_PASSWORD=$KEYCLOAK_ADMIN_PASSWORD
            - KC_DB_USERNAME=$POSTGRES_USER
            - KC_DB_PASSWORD=$POSTGRES_PASSWORD
            - KC_DB=postgres
            - KC_DB_URL_HOST=postgresql
            - KC_DB_URL_DATABASE=$POSTGRES_DB
            - KC_DB_URL_PORT=5432
            - KC_DB_SCHEMA=public
            - KEYCLOAK_PRODUCTION=true
            - KEYCLOAK_PROXY=edge
            - KEYCLOAK_EXTRA_ARGS=--auto-build
            - JAVA_OPTS=-XX:MaxRAMPercentage=75.0
        depends_on:
            - postgresql
        networks:
            - keycloak-network

networks:
    keycloak-network:
        driver: bridge

环境变量

访问方式

您可以通过以下地址访问Web界面：[***]

维护指南

日志查看

Elestio Keycloak Docker镜像将容器日志发送到stdout。要查看日志，可以使用以下命令：

docker-compose logs -f

要停止服务栈，可以使用以下命令：

docker-compose down

使用Docker Compose进行备份和恢复

为了使备份和恢复操作更加简单，我们使用文件夹卷挂载。您只需使用docker-compose down停止服务栈，然后备份docker-compose.yml文件所在文件夹中的所有文件和子文件夹。

创建ZIP存档

例如，如果您想创建一个ZIP存档，请导航到包含docker-compose.yml文件的文件夹，并使用以下命令：

zip -r myarchive.zip .

从ZIP存档恢复

要从ZIP存档恢复，请使用以下命令将存档解压缩到原始文件夹：

unzip myarchive.zip -d /path/to/original/folder

启动服务栈

备份完成后，您可以使用以下命令再次启动服务栈：

docker-compose up -d

就是这样！通过这些简单的步骤，您可以轻松使用Docker Compose备份和恢复数据卷。

相关链接

• Keycloak GitHub仓库
• Keycloak官方文档
• Elestio/keycloak GitHub仓库