luci-app-mihomo-traffic 是免费开源(Apache-2.0)的 OpenWrt / ImmortalWrt LuCI 插件,为 OpenClash 提供流量统计:基于 mihomo(Clash Meta,OpenClash 内核)的连接数据,按设备、出口节点、目标域名统计流量,带历史趋势和实时速率面板。
开启了全锥形 NAT(kmod-nft-fullcone)的路由器上,nlbwmon 收不到 conntrack 事件、统计一直为空;本插件不依赖 conntrack,直接读 mihomo 的连接表,可以替代 nlbwmon 做「哪台设备用了多少流量、走了哪个节点、访问了哪些网站」的统计。
截图中的设备、节点和流量均为演示数据,由 tests/demo-data.uc 生成。
- 按设备 / 出口节点 / 目标统计:每台设备的上传下载、每个代理节点(含 DIRECT)承担了多少流量、流量最大的域名,可任意组合维度,点击即可下钻过滤。
- 历史趋势:按小时(72 小时内)或按天(最长 30 天)查看,可按上传下载、设备或出口节点分组。
- 可视化:出口节点占比、设备 → 出口节点流向(桑基图)、目标排行,基于本地打包的 Apache ECharts,不依赖外网 CDN。
- 实时面板:浏览器直连 mihomo WebSocket,每秒刷新总速率曲线,以及各设备实时速率和最活跃的连接。
- 适配主题:Argon、Bootstrap 等主题的浅色和深色模式自动适配,强调色跟随主题。
- 轻量:采集进程用 ucode 编写,不装 Python、Node 或数据库;实测占单核约 1.3%,常驻内存约 3 MB。
- 命令行:
mihomo-traffic stats在 SSH 里直接出报表。
| 本插件 | nlbwmon | 外部面板(如 neko-master、clash-traffic-monitor) | |
|---|---|---|---|
| 全锥形 NAT 下可用 | ✅ | ❌ 收不到 conntrack 事件 | ✅ |
| 按出口节点、域名统计 | ✅ | ❌ 只有 IP 和协议 | ✅ |
| 运行位置 | 路由器本机,集成在 LuCI | 路由器本机 | 需要另一台机器或 Docker / Node 环境 |
| 额外依赖 | 无(ucode、curl 均为系统自带) | 无 | Node.js / Docker / 数据库 |
要求:OpenWrt 或 ImmortalWrt 24.10 及以上,已安装并运行 OpenClash(插件从 OpenClash 的配置读取 mihomo 控制端口和密钥)。
从 Releases 下载对应格式的安装包,传到路由器的 /tmp(如 scp -O luci-app-mihomo-traffic*.apk [email protected]:/tmp/)。插件与 CPU 架构无关,x86_64、aarch64、mips 等通用。
apk add --allow-untrusted /tmp/luci-app-mihomo-traffic-*.apkopkg install /tmp/luci-app-mihomo-traffic_*.ipk安装后采集服务自动启动,刷新 LuCI 即可在「状态 › Mihomo 流量」看到页面。数据从安装时开始累计。
下载新版本安装包,用同样的命令安装即可覆盖升级。安装后采集进程会自动重启,历史数据保留。
apk del luci-app-mihomo-traffic 或 opkg remove luci-app-mihomo-traffic。历史数据保留在 /etc/mihomo-traffic/,不需要可手动删除。
- 历史统计:选择时间范围、趋势分组和表格维度;点击图表或表格里的设备、节点、目标会加上过滤条件,点击过滤标签可以移除。
- 实时:切到这个页签时才连接 mihomo WebSocket,离开即断开。需要浏览器能直接访问路由器的 mihomo 控制端口(OpenClash 默认 9090);通过 HTTPS 访问 LuCI 时浏览器不允许连接
ws://,实时面板不可用。
mihomo-traffic stats # 最近 24 小时,按设备
mihomo-traffic stats 2 src,host # 最近 2 小时,按设备和目标
mihomo-traffic stats 168 node # 最近 7 天,按出口节点维度可选 src、node、host 及其组合。(内部) 行是 mihomo 自身发起的连接(链式代理的承载连接、DoH 等),与设备流量重复,不计入合计。
mihomo /connections ──每秒轮询──▶ mihomo-traffic(procd 托管的 ucode 进程)
│ 按「设备 / 出口节点 / 目标」累计字节增量
├─ 每分钟快照 ─▶ /tmp/mihomo-traffic.cur
└─ 每小时归档 ─▶ /etc/mihomo-traffic/YYYY-MM-DD.tsv
│
LuCI 页面 ◀── rpcd(ucode 插件 luci.mihomo-traffic)──┘ 查询、缓存、生成日汇总
└──── 实时面板直连 mihomo WebSocket(/traffic、/connections、/memory)
- 存储:每小时一行一个「设备 + 节点 + 目标」组合,一小时内不足 16 KB 的目标合并为
(小流量);保留 30 天,系统升级(sysupgrade)时自动保留。 - 查询:72 小时内按小时读原始数据;更长范围按天读日汇总(单日不足 1 MB 的目标合并为
(小流量)),30 天查询约 0.5 秒;数据不变时直接返回缓存。 - 精度:mihomo 接口提供的是连接快照而不是事件,存活不足 1 秒的连接、以及连接关闭前最后不到 1 秒的流量会漏计;直连(DIRECT)流量只有经过 mihomo 时才会被统计(如 TUN / 透明代理模式)。
nlbwmon 在全锥形 NAT 下为什么不工作?
kmod-nft-fullcone 会占用 conntrack 事件通知,nlbwmon 收不到连接事件,统计一直为空。本插件读取 mihomo 的连接表,不受影响。
统计和运营商、VPS 面板的流量对不上?
本插件统计的是经过 mihomo 的连接字节数,不含协议开销、重传以及不经过 mihomo 的流量;链式代理的承载连接单独显示为 (内部)。
会影响网速吗? 不会。采集进程只读取 mihomo 的 API,不在转发路径上,以最低优先级(nice 19)运行。
没装 OpenClash,只用独立的 mihomo(如 Nikki)可以吗?
目前不行。采集进程从 OpenClash 的 UCI 配置读取 mihomo 控制端口(cn_port,默认 9090)和密钥(dashboard_password),没有 OpenClash 配置就无法连接 mihomo。
数据存在哪里?会保留多久?
只存在路由器本地的 /etc/mihomo-traffic/,保留 30 天,sysupgrade 时自动保留。不需要时可手动删除该目录。
和 nlbwmon、neko-master 等怎么选? 路由器上开了全锥形 NAT,或想看到每个出口节点、每个域名的流量,用本插件;只需要按设备 / IP 的基础统计且没开全锥形 NAT,nlbwmon 就够用;想要独立于路由器运行的面板,可以看外部面板。对比见上方表格。
插件按 OpenWrt 标准 LuCI 包组织,可以放进任意 OpenWrt SDK 的 feed 编译:
# 在 OpenWrt SDK 目录
echo "src-link mihomo /path/to/feed" >> feeds.conf.default # feed 目录下放本仓库,目录名 luci-app-mihomo-traffic
./scripts/feeds update -a && ./scripts/feeds install luci-app-mihomo-traffic
make package/luci-app-mihomo-traffic/compileCI 使用 openwrt/gh-action-sdk 分别以 25.12(apk)和 24.10(ipk)SDK 构建,推送 v* 标签时自动发布 Release。
scripts/deploy.sh [email protected] # 把文件直接拷到路由器,重载 rpcd;采集逻辑有变化时才重启采集进程
sh tests/smoke.sh # 在路由器或 OpenWrt rootfs 容器里跑冒烟测试
scripts/build-echarts.sh # 重新按需打包 ECharts(需要 Node.js)演示环境(截图用,不要在真实路由器上跑,会覆盖已有数据):
ucode -L /usr/share/ucode tests/demo-data.uc # 在测试路由器或容器里生成 8 天的虚构数据
uv run --with websockets tests/fake-mihomo.py 19090 # 假的 mihomo WebSocket,给实时面板喂数据- 本插件只统计路由器本机 mihomo 的连接数据,不提供任何代理服务、节点、订阅或规则。
- 统计内容包括局域网设备的 IP、访问的域名和流量,只保存在路由器本地(
/etc/mihomo-traffic/),插件本身不会把数据发到路由器以外的地方。请只在你有权管理的网络中使用,并告知网络中的其他使用者;记录他人的上网行为前,请确认符合当地关于隐私和个人信息保护的法律法规。 - 遵守当地法律。本插件仅供学习和管理自有网络使用,不得用于任何违反所在国家或地区法律法规的用途。mihomo / OpenClash 的使用是否合规由使用者自己负责,使用者的行为及其后果与作者无关。
- 不提供任何担保。统计结果可能有误差(见「工作原理」),因使用本插件导致的数据丢失、设备异常或其他损失,作者不承担责任。
Apache-2.0 © 2026 hoobnn。可自由使用、修改和分发,需保留版权声明。内置的 Apache ECharts 同为 Apache-2.0,许可证见 ECHARTS-LICENSE。



