什么是 vnStat ？

vnStat 是一个网络流量监视器，它使用内核提供的网络接口统计信息作为信息源。这意味着 vnStat 实际上不会嗅探任何流量，并且无论网络流量速率如何，都可以确保系统资源的轻度使用。

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 vnStat ，选择第二个 vergoh/vnstat，版本选择版本选择 2.10 或者latest。

网络

勾选 使用与 Docker Host 相同的网络

环境

可变	值
`HTTP_PORT`	默认是 `8685`，如果没有冲突的话，就不要改
`TZ`	设置时区，国内用户设 `Asia/Shanghai`
`EXCLUDE_PATTERN`	用于将接口排除在监控之外的扩展 `regexp` 模式

老苏暂时用到这三个参数，其中 HTTP_PORT 是默认的，后两个参数需要自己添加

之所以要过滤 docker，是因为老苏折腾的机器里，docker 容器太多了

更多的环境编辑请参考官方文档：https://github.com/vergoh/vnstat-docker#environment-variables

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 运行容器
docker run -d 
    --restart=unless-stopped 
    --name vnstat 
    --network=host 
    -e HTTP_PORT=8685 
    -e TZ=Asia/shanghai 
    -e EXCLUDE_PATTERN=^docker
    vergoh/vnstat

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: '3'

services:
  vnstat:
    image: vergoh/vnstat
    container_name: vnstat
    restart: unless-stopped
    network_mode: host
    environment:  
      - HTTP_PORT=8685
      - TZ=Asia/shanghai
      - EXCLUDE_PATTERN=^docker

然后执行下面的命令

# 新建文件夹 vnstat
mkdir -p /volume2/docker/vnstat

# 进入 vnstat 目录
cd /volume2/docker/vnstat

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

Web

在浏览器中输入 http://群晖IP:8685 就能看到主界面

没有滤掉 docker的界面

过滤掉 docker 之后

等几分钟之后就会有数据了

默认情况下，流量统计信息以过去 48 小时的五分钟级别、过去 4 天的每小时级别、过去 2 个完整月的每日级别和永远的年度级别存储。数据保留期限完全由用户配置。还提供了总可见流量和热门天数列表。

另外提供了 JSON 输出，直接访问 http://群晖IP:8685/json.cgi

如果你使用 Prometheus，可以访问 http://群晖IP:8685/metrics

命令行

前面我们把 docker 容器的都关了，但其实可以通过命令行把需要的监控再添加进来

以容器 zentao 为例

第一步、查网络 ID

# 查网络id
docker network ls | grep <容器名称>

# 示例
docker network ls | grep zentao

在前面红框中得到的就是网络 ID（NETWORK ID）

第二步、在根据网络 ID 查网络详情

# 通过网络 ID 查 Gateway
docker network inspect <网络 ID>

# 示例
docker network inspect 144f6cddacab

找到 Gateway

第三步、通过 Gateway 查网卡

# 通过 gateway 地址查网卡
ip addr | grep '<gateway IP>'

# 示例
ip addr | grep '192.168.80.1'

另一种老苏觉得不太正规的方法似乎更简单有效，将第一步获得的络 ID 取前 8位，就是 144f6cdd，再加上前缀 docker 就可以了 🙂 以上正规、不正规的方法，都只适用于 bridge 模式的容器，并不适用于 Host 模式的容器；

第四步、添加监控

假设容器的名字是 vnstat

# 添加监控
docker exec vnstat vnstat -i <网卡 ID> --add

# 示例
docker exec vnstat vnstat -i docker-144f6cdd --add

开始也是没数据的

要过几分钟

但是 docker-144f6cdd 时间久了还是会不记得的，因此要给个别名来标记一下

# 起个别名
docker exec vnstat vnstat -i <网卡 ID> --setalias "<别名>"

# 示例
docker exec vnstat vnstat -i docker-144f6cdd --setalias "zentao"

刷新网页，名称已经变为了 zentao（docker-144f6cdd）

访问一下 zentao，数据会有变化，说明监控是没问题的

如果要删除这个监控的话，只要输入👇的命令就可以了

# 删除监控
docker exec vnstat vnstat -i <网卡 ID> --remove --force

# 示例
docker exec vnstat vnstat -i docker-144f6cdd --remove --force

参考文献

vergoh/vnstat: vnStat – a network traffic monitor for Linux and BSD
地址：https://github.com/vergoh/vnstat

vergoh/vnstat-docker: vnStat in a container with image output via http
地址：https://github.com/vergoh/vnstat-docker

vnStat – a network traffic monitor for Linux and BSD
地址：https://humdi.net/vnstat/

@所有人：写文不易，如果你都看到了这里，请点个赞和在看，分享给更多的朋友；为确保你能收到每一篇文章，请主页右上角设置星标。