logo NodeSeekbeta

Komari Traffic Hub:由 Telegram 流量 Bot 升级而来的 Komari 统计与告警面板

之前发过一个基于 Komari 的 Telegram 流量统计 Bot,当时主要功能很简单:
每天推送日报、每周推送周报、每月推送月报,再加几个 /today/week/top 6h 之类的 TG 命令。

这段时间又改了不少,现在项目已经从单纯的 TG Bot 脚本,变成了一个 Docker 版的 Komari Traffic Hub

项目地址:

https://github.com/wirelouis/komari-traffic-hub

现在主要功能

  • Telegram 日报 / 周报 / 月报推送
  • /today/week/month 查询当前周期流量
  • /top/top 6h/top 24h/top week/top month 查询 Top N 流量榜
  • Web 面板查看今日 / 本周 / 本月 / 节点排行 / 长期分析
  • Web 面板里配置推送计划,不再依赖 crontab
  • 支持手动测试 Telegram 推送
  • 支持任务运行历史和系统状态查看
  • 支持节点绑定和节点详情查看
  • 支持区间分析和 CSV 导出
  • 支持智能告警
  • 支持 AI 问答,能直接问“最近 7 天哪台机器流量最高”这种问题
  • Docker / docker-compose 部署

相比最早版本主要更新点

1. 从脚本变成了 Web 管理面板

最早版本基本是一个 Python 脚本 + Telegram 命令。
现在加了 Web 面板,可以直接在浏览器里看总览、节点排行、长期分析、告警状态、任务历史,不用什么都靠 TG 命令敲。

2. 推送计划不用 crontab 了

以前日报 / 周报 / 月报靠 crontab 跑。
现在可以在 Web 面板里创建每日、每周、每月推送计划,支持完整报表和 Top 报表,也能直接测试发送。

这个改动对懒人比较友好,毕竟 crontab 写错一分钟就开始玄学。

3. 增加智能告警

现在支持节点连续采样失败、窗口流量超阈值、今日流量超阈值、单节点超阈值等告警。
也支持冷却时间、静默时段、恢复通知和单独告警 chat。

简单说就是:不只是月底看谁流量炸了,而是炸的时候就能提醒你。

4. 增加 AI 问答

如果配置了 OpenAI 兼容接口,可以直接在 Telegram 或 Web 面板里问:

最近 24 小时哪台机器流量最高?
本月总流量是多少?
最近 7 天有没有异常?

它会基于当前统计数据回答,不是单纯聊天机器人瞎编。

5. 数据存储改成 SQLite 为主

早期更多是 JSON 文件存历史。
现在核心数据进 traffic.db,长期运行、任务记录、Web 查询都更方便。

6. 增加长期分析和导出

现在不只是固定日报周报月报,还能在 Web 面板里看长期分析、区间统计,并导出 CSV。

7. Docker 部署更完整

现在已经有 GHCR 镜像,compose 里主要就是 botweb 两个服务。
部署细节就不在帖子里贴一大坨了,GitHub README 里有。

适合谁

适合已经在用 Komari 管多台 VPS / 独服 / 小鸡的坛友。

如果你只是偶尔打开 Komari 看一眼,那可能没必要。
但如果你想要:

  • 每天自动收到流量日报
  • 月底知道哪台机器最能吃流量
  • 节点异常或流量突增时自动提醒
  • 有个简单 Web 面板看长期趋势
  • Telegram 里随手查流量

那这个项目应该能省点事。

最后

这个项目最早真就是“AI 搓了个 TG Bot 脚本”,现在一路加需求,已经有点从小脚本进化成小面板了。

代码不敢说多优雅,但自用目前比较顺手。
有兴趣的可以去 GitHub 看 README 部署,欢迎提 issue / PR。

项目地址:

https://github.com/wirelouis/komari-traffic-hub

你好啊,陌生人!

我的朋友,看起来你是新来的,如果想参与到讨论中,点击下面的按钮!

📈用户数目📈

目前论坛共有61246位seeker

🎉欢迎新用户🎉