告别盲猜：把vnStat数据接入Prometheus+Grafana，打造你的家庭网络监控仪表盘

从vnStat到Prometheus：构建家庭网络流量监控体系的完整指南

当你发现家里的网络突然变慢，第一反应是什么？是重启路由器，还是打电话给运营商抱怨？其实，更聪明的做法是建立一个可视化的网络监控系统，让你能精确掌握每台设备的流量使用情况。本文将带你深入vnStat与Prometheus的集成方案，打造一个专业级的家庭网络监控仪表盘。

1. 为什么需要升级vnStat的监控能力

vnStat作为经典的命令行网络监控工具，确实能提供基础流量统计。但它的局限性也很明显：

• 数据可视化简陋：内置的Web界面图表简单，无法自定义
• 缺乏历史数据分析：默认只保留有限时间范围的数据
• 无法设置告警：当流量异常时无法及时通知
• 孤立系统：难以与其他监控指标（如CPU、内存）关联分析

这正是我们需要将vnStat数据接入Prometheus+Grafana生态系统的原因。通过这种组合，你可以获得：

# vnStat提供的Prometheus格式指标示例 vnstat_traffic_total{interface="eth0",type="rx"} 123456789 vnstat_traffic_total{interface="eth0",type="tx"} 987654321

提示：vnStat从2.6版本开始原生支持Prometheus格式的/metrics端点，这为我们的集成提供了极大便利

2. 容器化vnStat的部署与配置

推荐使用Docker部署vnStat，这能保证环境一致性并简化管理。以下是关键配置要点：

2.1 基础docker-compose配置

version: '3' services: vnstat: image: vergoh/vnstat:latest container_name: vnstat restart: unless-stopped network_mode: host volumes: - ./vnstat:/var/lib/vnstat environment: - HTTP_PORT=8685 - TZ=Asia/Shanghai - EXCLUDE_PATTERN=^docker

关键参数说明：

2.2 监控特定容器网络

对于Docker bridge网络中的容器，需要额外配置：

# 查找容器网络ID docker network ls | grep <容器名称> # 添加到vnStat监控 docker exec vnstat vnstat -i docker-<前8位网络ID> --add

3. Prometheus集成配置

3.1 基础抓取配置

在prometheus.yml中添加以下job：

scrape_configs: - job_name: 'vnstat' static_configs: - targets: ['localhost:8685'] scrape_interval: 30s

3.2 指标解析与优化

vnStat提供的核心指标包括：

• vnstat_traffic_total：累计流量（分rx/tx）
• vnstat_traffic_rate：当前传输速率
• vnstat_interface_up：接口状态

建议使用的Prometheus记录规则：

groups: - name: vnstat rules: - record: instance:vnstat:traffic:rate5m expr: rate(vnstat_traffic_total[5m])

4. Grafana仪表盘设计

4.1 核心面板设计

每日流量消耗面板：

• 使用Stat面板显示当日已用流量
• 添加Gauge显示当月流量使用百分比
• 折线图展示最近7天流量趋势

实时带宽面板：

• Time series图表展示rx/tx速率
• 添加阈值告警线（如100Mbps）

{ "panels": [ { "title": "实时带宽", "type": "timeseries", "targets": [ { "expr": "vnstat_traffic_rate{interface='eth0',type='rx'}", "legendFormat": "接收速率" } ] } ] }

4.2 实用技巧

1. 变量化接口选择：

   • 创建$interface变量：label_values(vnstat_traffic_total, interface)
   • 在面板中使用变量替代硬编码接口名

2. 流量预测： 使用Grafana的预测功能，基于历史数据预测月末流量使用情况

3. 告警设置：

   • 当日流量超过设定阈值
   • 异常流量波动检测（同比/环比）

5. 高级应用场景

5.1 多主机监控

通过修改Prometheus配置，可以集中监控家庭网络中多台主机的流量：

scrape_configs: - job_name: 'home-network' static_configs: - targets: - 'router:8685' - 'nas:8685' - 'media-center:8685'

5.2 与智能家居集成

将网络监控数据与Home Assistant集成，实现自动化场景：

• 当检测到孩子房间设备夜间高流量时，自动限制带宽
• 根据网络使用情况自动切换QoS策略

5.3 长期数据存储优化

对于长期数据存储，建议：

1. 配置Prometheus的远程写入到VictoriaMetrics或InfluxDB
2. 设置适当的保留策略（原始数据30天，聚合数据1年）
3. 使用Downsampling减少历史数据存储压力

6. 故障排查与维护

常见问题解决方案：

维护建议：

• 每月检查一次数据完整性
• 定期备份/var/lib/vnstat目录
• 更新容器镜像时注意配置迁移

这套系统在我家稳定运行了18个月，成功捕捉到多次异常流量情况，包括一次IoT设备被入侵后的异常数据传输。最实用的功能是设置了孩子上网时段的流量限额告警，再也不用担心夜间下载影响全家网络了。