cityhawk/mrtg

CityHawk MRTG Docker镜像文档

镜像概述和主要用途

本镜像提供了一个简单的容器化解决方案，用于运行MRTG（Multi Router Traffic Grapher）——一款广泛使用的网络流量监控工具。通过容器化部署，简化了MRTG的环境配置流程，同时支持数据持久化和自定义配置，适用于需要监控网络设备流量的场景。

核心功能和特性

• 容器化运行：无需复杂的系统环境配置，直接通过Docker容器运行MRTG
• 数据持久化：监控数据存储在容器内的/mrtg_data目录，支持通过卷挂载实现数据持久化
• 配置灵活性：支持挂载自定义mrtg.cfg配置文件，满足不同监控需求
• 轻量部署：简化MRTG部署流程，降低维护成本

使用场景和适用范围

适用于需要监控网络设备（如路由器、交换机）流量的网络管理员或运维人员，尤其适合希望通过容器化方式快速部署和管理MRTG的用户。

使用方法和配置说明

准备配置文件

MRTG运行需要mrtg.cfg配置文件。可通过容器内的cfgmaker工具生成，步骤如下：

1. 先启动临时容器：

   bash
   docker run -it --rm cityhawk/mrtg /bin/sh
   

2. 在容器内运行cfgmaker生成配置（需根据实际网络环境调整参数）：

   bash
   cfgmaker --global 'WorkDir: /mrtg_data' community@router_ip > /etc/mrtg.cfg
   

3. 将生成的mrtg.cfg文件复制到宿主机本地目录（如/path/to/cfg/）

运行MRTG容器

通过以下命令启动MRTG容器，挂载数据卷和配置文件：

bash
docker run -d -t \
  -v /path/to/my/data:/mrtg_data/ \  # 挂载数据目录，用于持久化监控数据
  -v /path/to/cfg/mrtg.cfg:/etc/mrtg.cfg \  # 挂载自定义配置文件
  cityhawk/mrtg

参数说明：

• -d：后台运行容器
• -t：分配伪终端
• -v /path/to/my/data:/mrtg_data/：将宿主机目录挂载到容器内的/mrtg_data，用于保存监控数据
• -v /path/to/cfg/mrtg.cfg:/etc/mrtg.cfg：将宿主机的配置文件挂载到容器内的/etc/mrtg.cfg

提供Web访问

MRTG生成的监控图表为HTML文件，需通过Web服务器提供访问。推荐使用Nginx，示例如下：

bash
docker run -d -t \
  -p 9080:80 \  # 映射端口到宿主机9080
  -v /path/to/my/data:/usr/share/nginx/html \  # 挂载MRTG数据目录到Nginx网页根目录
  nginx:alpine

启动后，通过http://宿主机IP:9080即可访问MRTG监控页面。

参考链接

更多信息请查看项目GitHub仓库：https://github.com/CityHawk/cityhawk-mrtg