szabberoni/keycloak

Oxidized-Keycloak Docker镜像文档

镜像概述

本镜像提供Oxidized与Keycloak认证集成的预配置Docker Compose栈。Oxidized是一款网络设备配置备份工具，可自动备份网络设备（如路由器、交换机等）的配置文件；Keycloak是开源的身份认证与访问管理工具。该镜像通过预配置的Compose环境，实现了Oxidized的安全访问控制，适用于需要对网络设备配置备份进行身份认证管理的场景。

核心功能与特性

• 配置备份自动化：集成Oxidized核心功能，支持定期自动备份网络设备配置，支持多种网络设备类型（如Cisco、Juniper、Huawei等）。
• 身份认证集成：通过Keycloak实现用户身份认证与授权，确保只有授权用户可访问Oxidized管理界面。
• 预配置环境：提供完整的Docker Compose配置，包含Oxidized、Keycloak及依赖服务，无需手动配置复杂环境。
• 快速部署：简化部署流程，通过Compose一键启动所有服务，降低运维复杂度。

使用场景

• 企业网络运维：对网络设备配置进行集中备份与安全管理。
• 多用户协作环境：需要对配置备份操作进行权限控制的团队。
• 安全合规需求：需满足身份认证与访问审计要求的网络管理场景。

使用方法

前提条件

• 安装Docker及Docker Compose
• 网络环境可访问互联网（用于拉取镜像）

获取项目

克隆GitHub仓库获取预配置文件：

bash
git clone https://github.com/Simone-Zabberoni/oxidized-keycloak.git
cd oxidized-keycloak

配置参数

根据需求修改.env文件或docker-compose.yml中的配置参数，主要包括：

• Keycloak相关：管理员账户、密码、 Realm 配置等
• Oxidized相关：设备列表配置、备份周期、存储路径等
• 网络端口映射：可根据实际需求调整服务端口

启动服务

使用Docker Compose启动所有服务：

bash
docker-compose up -d

访问服务

• Keycloak管理界面：http://<主机IP>:8080（默认端口，可在配置中修改），使用预设管理员账户登录并配置用户与权限。
• Oxidized管理界面：http://<主机IP>:8888，通过Keycloak认证后访问，开始配置网络设备备份任务。

停止服务

bash
docker-compose down

注意事项

• 首次启动时，Keycloak需初始化数据库，可能需要几分钟时间。
• 建议在生产环境中修改默认账户密码及密钥，增强安全性。
• 根据网络设备数量及备份需求，调整Oxidized的资源配置（如内存、CPU限制）。