bootc/oxidized

Oxidized Docker镜像

镜像概述和主要用途

Oxidized是一款网络设备配置备份工具，旨在替代传统的RANCID。本项目提供构建Oxidized及Oxidized Web的Docker容器镜像，解决上游官方Dockerfile生成镜像体积过大的问题。项目生成的镜像每周自动重建，确保软件版本和依赖组件保持最新状态。

核心功能和特性

• 网络配置备份：支持各类网络设备（路由器、交换机、防火墙等）的配置自动备份
• 替代RANCID：作为RANCID的现代替代品，提供更简洁的架构和更高效的备份能力
• 轻量级设计：优化镜像构建流程，相比上游镜像显著减小体积，降低资源占用
• 定期更新：每周自动重建镜像，确保安全补丁和功能更新及时应用
• Web界面支持：包含Oxidized Web组件，提供直观的网页管理界面

使用场景和适用范围

适用于需要集中管理网络设备配置的各类场景：

• 企业网络运维团队对多品牌网络设备的配置备份需求
• 数据中心网络基础设施的配置版本控制与恢复
• 互联网服务提供商（ISP）对大量网络设备的批量配置管理
• 教育机构、***部门等组织的网络设备标准化配置备份

维护者信息

本项目及生成的Docker镜像由https://github.com/bootc%E7%BB%B4%E6%8A%A4%EF%BC%8C%E6%AC%A2%E8%BF%8E%E5%8D%8F%E4%BD%9C%E8%80%85%E5%8F%82%E4%B8%8E%E5%BC%80%E5%8F%91%E3%80%82%E9%A1%B9%E7%9B%AE%E6%BA%90%E4%BB%A3%E7%A0%81%E7%9A%84 canonical 地址位于个人GitLab CE实例：<[***]>。

许可证信息

Oxidized本身采用Apache-2.0许可证分发。本Docker镜像项目同样采用Apache-2.0许可证。请注意，通过本仓库文件构建的Docker镜像可能包含受其他开源许可证保护的软件组件。

使用方法和配置说明

基本部署示例

Docker Run命令

bash
docker run -d \
  --name oxidized \
  -v /host/path/to/config:/root/.config/oxidized \
  -v /host/path/to/data:/root/.local/share/oxidized \
  -p 8888:8888 \
  bootc/oxidized:latest

Docker Compose配置

yaml
version: '3.8'
services:
  oxidized:
    image: bootc/oxidized:latest
    container_name: oxidized
    volumes:
      - ./oxidized/config:/root/.config/oxidized  # 配置文件目录
      - ./oxidized/data:/root/.local/share/oxidized  # 备份数据目录
    ports:
      - "8888:8888"  # Web界面端口
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai  # 设置时区

核心配置说明

Oxidized的主要配置文件为config，位于容器内/root/.config/oxidized目录。典型配置项包括：

• 设备列表：通过router.db文件定义需备份的设备信息（格式：设备名称:设备类型:IP地址）
• 备份设置：配置备份周期、日志级别、输出格式（如Git仓库、文件系统等）
• 连接参数：定义设备访问方式（SSH、Telnet等）及认证信息

详细配置选项请参考https://github.com/ytti/oxidized%E3%80%82