fboaventura/dckr-mrtg Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务
fboaventura/dckr-mrtg自动构建
fboaventura
运行MRTG（多路由器流量绘图器）的Docker镜像，支持多架构，用于网络设备流量监控与图形化展示，集成lighttpd提供Web界面，可自定义MIB文件和监控配置，持久化存储监控数据。
8 次收藏下载次数: 0状态：自动构建维护者：fboaventura仓库类型：镜像最近更新：25 天前
fboaventura/dckr-mrtg
运行MRTG（多路由器流量绘图器）的Docker实例。该镜像基于Alpine构建，支持Alpine镜像的所有架构，其中amd64和arm64v8已验证可用。
| 架构 | 已验证 |
|---|---|
| amd64 | 是 |
| arm64v8 | 是 |
| arm32v6 | 否 |
| arm32v7 | 否 |
| i386 | 否 |
| ppc64le | 否 |
| s390x | 否 |
| riscv64 | 否 |
目录
- 概述
- 核心功能与特性
- 使用场景
- 使用方法
- 环境变量
- 持久化存储
- 命令行运行
- docker-compose配置
- 变更日志
- 许可证
概述
fboaventura/dckr-mrtg是一个预配置的Docker镜像，用于快速部署MRTG网络流量监控工具。MRTG通过SNMP协议收集网络设备（如路由器、交换机）的流量数据，并生成图形化报告。该镜像集成lighttpd作为Web服务器，提供监控数据的Web访问界面，支持rrdtool进行数据处理，同时允许用户添加自定义MIB文件以扩展设备支持。
核心功能与特性
- MRTG集成：完整支持MRTG工具链，实现网络流量数据采集与图形化展示
- 多架构支持：基于Alpine构建，支持amd64、arm64v8等多种硬件架构
- Web服务：集成lighttpd提供Web访问，默认端口80，可直接查看监控报告
- 数据处理：支持rrdtool存储和处理时间序列数据，生成历史趋势图表
- 灵活配置：通过环境变量自定义监控参数、Web路径、用户权限等
- MIB扩展：支持添加自定义MIB文件，适配特定厂商网络设备
- 持久化存储：关键配置和监控数据支持卷挂载，确保数据不丢失
- 时区配置：支持通过TZ环境变量设置时区，确保时间显示准确
使用场景
- 个人或家庭网络中监控路由器、交换机的实时流量
- 小型企业网络设备流量监控与带宽使用分析
- IT团队对网络设备进行性能监控和故障排查
- 需要图形化展示网络流量趋势的教学或演示环境
使用方法
环境变量
镜像支持通过环境变量自定义配置，以下是主要变量及默认值：
| 变量名 | 默认值 | 描述 |
|---|---|---|
CFGMAKEROPTIONS | "" | 传递给cfgmaker的额外选项，如--zero-speed=***（参考manpage） |
ENABLE_V6 | "no" | 是否启用IPv6支持，监控IPv6设备时设为"yes" |
GRAPHOPTIONS | "growright, bits" | 图表生成选项，默认右扩展、以比特为单位（选项参考MRTG文档） |
GROUPID | 101 | lighttpd运行用户组ID，建议与USERID一致或根据卷权限调整 |
HOSTS | community:host[:version[:port]] | 监控目标主机，格式为社区名:主机[:SNMP版本[:端口]]，多主机用逗号分隔（如public:192.168.1.1:2c:161,admin:10.0.0.1） |
INDEXMAKEROPTIONS | "" | 传递给indexmaker的额外选项，如--nolegend（参考manpage） |
MIBSDIR | "/mrtg/mibs" | 自定义MIB文件存放目录，容器会加载该目录下的所有MIB文件 |
MRTG_COLUMNS | 2 | 监控页面索引表格的列数，调整以适应多主机展示 |
PATHPREFIX | "" | Web访问路径前缀（不含尾斜杠），用于反向代理场景（如"/mrtg"） |
REGENERATEHTML | "yes" | 容器重启时是否重新生成index.html（设为非"yes"则保留自定义修改，原文件重命名为index.old） |
TZ | "UTC" | 时区设置，如"Asia/Shanghai" |
USERID | 100 | lighttpd运行用户ID，建议设为1000以上以适配卷权限 |
WEBDIR | "/mrtg/html" | Web页面和RRD数据存储目录 |
持久化存储
容器使用以下目录存储关键数据，建议通过卷挂载实现持久化：
/etc/mrtg/conf.d：MRTG配置文件目录（生成的和自定义的配置）/mrtg/html：Web页面、RRD数据文件目录（监控报告和历史数据）/mrtg/mibs：自定义MIB文件目录（扩展设备支持）/mrtg/fonts：自定义字体目录（调整图表字体）
命令行运行
快速启动示例（非持久化）：
bashdocker run -d -p 8880:80 -e "HOSTS='public:192.168.1.1:2c'" fboaventura/dckr-mrtg:latest
持久化启动（挂载本地目录）：
bash# 创建本地目录 mkdir -p ./conf.d ./html ./mibs # 启动容器并挂载卷 docker run -d \ -p 8880:80 \ -e "HOSTS='public:192.168.1.1:2c,admin:10.0.0.1'" \ -e "TZ='Asia/Shanghai'" \ -e "USERID=1000" \ -e "GROUPID=1000" \ -v ./conf.d:/etc/mrtg/conf.d \ -v ./html:/mrtg/html \ -v ./mibs:/mrtg/mibs \ fboaventura/dckr-mrtg:latest
访问监控页面：浏览器打开http://<服务器IP>:8880
docker-compose配置
创建docker-compose.yml文件：
yaml--- services: mrtg: image: fboaventura/dckr-mrtg:latest hostname: mrtg restart: always ports: - "8880:80" # 宿主机端口:容器端口（容器内固定80） volumes: - ./conf.d:/etc/mrtg/conf.d # 配置文件持久化 - ./html:/mrtg/html # 监控数据和Web页面持久化 - ./mibs:/mrtg/mibs # 自定义MIB文件 - /etc/localtime:/etc/localtime:ro # 同步宿主机时区（可选） environment: TZ: "Asia/Shanghai" # 设置时区 HOSTS: "public:192.168.1.1:2c,admin:10.0.0.1:2c:161" # 监控主机列表 USERID: 1000 # 运行用户ID（适配卷权限） GROUPID: 1000 # 运行用户组ID REGENERATEHTML: "yes" # 重启时重新生成索引页 CFGMAKEROPTIONS: "--zero-speed=***" # cfgmaker额外选项 MRTG_COLUMNS: 3 # 索引表格列数 tmpfs: - "/run" # 临时文件系统，提升性能
启动服务：
bashdocker-compose up -d
变更日志
v2.5.8 - 2025.09.08
- 修复issue #33报告的错误
- 更新软件包版本
v2.5.7 - 2025.04.07
- 更新软件包版本
- 重构
mrtg.sh启动脚本 - 添加supervisord支持进程管理（修复#32）
- 支持Home Assistant插件（修复#29）
v2.5.6 - 2024.09.20
- 更新软件包版本
- 修复
indexmaker和cfgmaker选项传递问题（修复#25） - 添加对devcontainers的支持
- 构建时添加provenance和SBOM证明
v2.5.5 - 2024.08.22
- 引入版本化
dev分支用于开发 - 添加
net-snmp-libs包，包含标准MIB文件 - 新增
MIBSDIR环境变量指定MIB文件路径 - 文档添加目录和MIBs说明（感谢@mlazarov）
- 修复
14all.cgi脚本警告（#21和#23） - 移除lighttpd配置中的过时选项
v2.5.4 - 2024.07.11
- 更新软件包版本
- 更新
14all.cgi脚本，支持CSV格式数据导出 - 新增
MRTG_COLUMNS环境变量控制索引页列数
v2.5.3 - 2023.11.25
- 强制清理字体缓存，避免fontconfig错误
- 修复Dockerfile中的安全问题
- 修复lighttpd配置错误
- 软件包指定固定版本
- 添加Alpine软件包更新命令
v2.5.2 - 2023.08.29
- 更新Alpine版本以减少漏洞
- 修复使用PathPrefix时图标缺失问题（@michaelkrieger）
v2.5.1 - 2023.01.15
- 修复自动构建，发布多架构版本和文档
- 文档添加卷挂载说明
v2.5.0 - 2023.01.15
- 支持设置
USERID和GROUPID，适配卷映射场景（@TweakM） - 新增
REGENERATEHTML选项，控制是否重新生成index.html（@TweakM） - 支持为
indexmaker添加额外选项，增强自定义能力（@TweakM） - 更新文档并修复拼写错误
v2.4.0 - 2022.08.26
- 支持多架构构建并发布到Docker Hub
latest标签跟随最新发布版本- 升级Alpine版本
v2.3.2 - 2022.08.25
- 示例中添加
/etc/localtime挂载（@michaelkrieger） - 支持Path Prefix路径前缀（@michaelkrieger）
- 更新Alpine版本
v2.3.1 - 2021.09.03
- 修复README中HTML文件夹示例配置（#4）
- 修复lighttpd守护进程标志
- 添加自定义端口支持
v2.3.0 - 2021.06
- 更新Alpine版本
- 添加SNMP版本支持
- 集成rrdtool
- 替换NGINX为lighttpd
- Web目录从
/usr/share/nginx/html迁移至/mrtg/html - 修复
latest标签兼容性问题 - 调整版本控制策略，仅支持标签版本
v2.2.0 - 2020.04
- 更新Alpine版本
- docker-compose.yml升级至3.5版本
- 修复
HOST为空时的回退逻辑
v2.1.1 - 2019.10
- 更新Alpine和MRTG版本
v1.3 - 2019.08
- 更新Alpine版本
v1.2 - 2019.05
- 更新Alpine版本
v1.1 - 2018.10
- 更新MRTG和Alpine版本
v1.0.0 - 2017.08
- 初始版本发布
许可证
镜像拉取常见问题
使用与功能问题
错误码与失败问题
manifest unknown 错误：镜像不存在或标签错误
manifest unknown 错误
TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误
TLS 证书验证失败
DNS 解析超时：无法解析镜像仓库地址或连接超时
DNS 解析超时
410 Gone 错误：Docker 版本过低导致协议不兼容
410 错误：版本过低
402 Payment Required 错误：流量耗尽错误提示
402 错误：流量耗尽
401 UNAUTHORIZED 错误：身份认证失败或登录信息错误
身份认证失败错误
429 Too Many Requests 错误：请求频率超出专业版限制
429 限流错误
Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）
凭证保存错误
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"