mbixtech/observium

Observium Community Edition Docker容器

镜像概述和主要用途

本镜像为Observium Community Edition的Docker容器化版本。Observium是一款低维护成本的自动发现网络监控平台，支持广泛的设备类型、平台和操作系统，包括Cisco、Windows、Linux、HP、Juniper、Dell、FreeBSD、Brocade、Netscaler、NetApp等。其核心价值在于提供美观、强大且简洁直观的界面，实时展示网络健康状态和设备状态。

核心功能和特性

• 自动发现：支持网络设备自动发现，减少手动配置工作量
• 多设备支持：兼容主流网络设备、服务器和操作系统
• 直观界面：提供美观且功能丰富的监控界面，展示网络健康状态
• 低维护成本：自动化配置和监控流程，降低运维复杂度
• 数据持久化：支持监控数据（RRD数据库）和日志的持久化存储

可用平台

• AMD64（Intel x86_64）：https://hub.docker.com/r/mbixtech/observium/
• ARM32v7（树莓派2/3）：https://hub.docker.com/r/mbixtech/arm32v7-observium/

可用标签

• 24.12.***-jammy、24.12-jammy、latest（仅AMD64，基于Ubuntu 24.04）
• 23.9.***-jammy、23.9-jammy、latest（仅AMD64，基于Ubuntu 22.04）
• 23.9.***、23.9（仅AMD64）
• 22.5.***、22.5（仅AMD64）
• 20.9.***、20.9
• 19.8.***、19.8
• 18.9.1_r1.0
• 17.9.8859、17.9

使用方法

可选择以下A或B方式运行Observium。

A. 手动运行容器

• 准备Docker容器工作目录，示例如下：

bash
  $ mkdir /home/docker/observium
  $ cd /home/docker/observium
  $ mkdir data logs rrd

• 运行官方MariaDB容器：

bash
  $ docker run --name observiumdb \
    -v /home/docker/observium/data:/var/lib/mysql \
    -e MYSQL_ROOT_PASSWORD=passw0rd \
    -e MYSQL_USER=observium \
    -e MYSQL_PASSWORD=passw0rd \
    -e MYSQL_DATABASE=observium \
    -e TZ=Asia/Bangkok \
    mariadb

• 运行Observium容器：

bash
  $ docker run --name observiumapp --link observiumdb:observiumdb \
    -v /home/docker/observium/logs:/opt/observium/logs \
    -v /home/docker/observium/rrd:/opt/observium/rrd \
    -e OBSERVIUM_ADMIN_USER=admin \
    -e OBSERVIUM_ADMIN_PASS=passw0rd \
    -e OBSERVIUM_DB_HOST=observiumdb \
    -e OBSERVIUM_DB_USER=observium \
    -e OBSERVIUM_DB_PASS=passw0rd \
    -e OBSERVIUM_DB_NAME=observium \
    -e OBSERVIUM_BASE_URL=http://yourserver.yourdomain:8080 \
    -e TZ=Asia/Bangkok \
    -p 8080:80 \
    mbixtech/observium

注意：

• 必须将两个容器环境参数中指定的密码替换为您的安全密码。

B. 使用Docker Compose

• 按以下说明创建Docker容器的额外工作目录：

bash
  $ mkdir /home/docker/observium
  $ cd /home/docker/observium
  $ mkdir data logs rrd

注意：您可以将/home/docker/observium目录更改为所需目录，同时需要修改docker-compose.yml文件中的卷映射目录。

• 从https://github.com/somsakc/docker-observium/tree/master/amd64%E4%B8%8B%E8%BD%BD%60docker-compose.yml%60%E6%96%87%E4%BB%B6%EF%BC%8C%E5%B9%B6%E5%B0%86%E5%85%B6%E6%94%BE%E7%BD%AE%E5%9C%A8%60/home/docker/observium%60%E7%9B%AE%E5%BD%95%E4%B8%AD%E3%80%82

• 运行数据库和Observium容器：

bash
  $ docker compose up

变更记录

• [2025-02-15] 构建基于Observium CE 24.12.***的Docker镜像（仅AMD64平台）
  • 将基础镜像升级至Ubuntu 24.04（amd64/Dockerfile）
  • 支持运行最新的Observium 24.12（amd64/Dockerfile）
  • 更新docker-compose.yml以符合推荐最佳实践
  • 更新README.md包含构建镜像说明
• [2024-01-01] 构建基于Observium CE 23.9.***的Docker镜像（仅AMD64平台）
  • 将拉取请求#28合并至master分支
  • 修改amd64/observium-init.sh文件，当指定TZ环境变量时更新容器内的/etc/timezone和/etc/localtime，影响RRD图表
  • 修改amd64/observium-init.sh文件，使用MYSQL_PWD变量配合mysql命令
  • 修改amd64/Dockerfile文件，移除mysql-server包
• [2022-07-17] 构建基于Observium CE 22.5.***的Docker镜像（仅AMD64平台）
  • 修复amd64/Dockerfile中缺失logrotate的问题
  • 在amd64/Dockerfile中添加libphp-phpmailer包
• [2021-11-01] 构建基于Observium CE 21.10.***的Docker镜像（仅AMD64平台）
  • 添加monitoring-plugins-basic、monitoring-plugins-common和monitoring-plugins-standard包
• [2021-08-26] 构建基于Observium CE 20.9.***的Docker镜像（仅AMD64平台）
  • 将基础镜像升级至ubuntu:20.04
  • 根据Observium安装文档升级软件包至更高版本，如php-7.4
  • 修改docker-compose.yml文件并添加.env文件用于指定项目名称（参见下方源码仓库）
• [2020-02-16] 增强基于Observium CE 19.8.***的Docker镜像
  • 修改容器首次运行时的初始化/启动脚本，增加数据库初始化信息
  • 将Apache http访问日志和错误日志移至/opt/observium/logs目录
  • 添加所有 cron 任务日志存储至/opt/observium/logs目录
  • 添加日志轮转功能用于轮转/opt/observium/logs目录中的日志
  • 将容器工作目录改为/opt/observium以便于管理内部的Observium
  • 修复supervisord.conf中指定的无效cron参数
  • 修改Dockerfile文件
• [2018-10-28] 添加"功能请求：OBSERVIUM_BASE_URL #3"功能
• [2017-08-19] 修复"DB Error 1044: Access denied for user 'observium'@'%' to database 'observium'"错误，将数据库容器的MYSQL_DB_NAME环境变量替换为MYSQL_DATABASE（由于官方mariadb镜像的环境变量定义变更）
• [2017-08-19] 添加适用于树莓派2/3（arm32v7）平台的Observium镜像

源码仓库

项目源码参见：https://github.com/somsakc/observium

参考资料

• 官方Observium网站 [***]
• Observium网站的Ubuntu安装文档 [[***]]