{"repo":"wirelouis/komari-traffic-hub","free":true,"listed":false,"github":"https://github.com/wirelouis/komari-traffic-hub","clone":"git clone https://github.com/wirelouis/komari-traffic-hub.git","description":"基于 Komari 探针的 Docker 化流量统计管理中心，提供 Telegram 日/周/月报、任意时间窗口 Top 排行、Web 分析面板、智能告警与 AI 问答，适合多节点长期流量监控。","language":"Python","stars":19,"topics":["docker","docker-compose","observability","telegeram-bot","traffic-monitoring","alerts","web-dashboard"],"license":null,"category":"deployment-docker-iac","readme_excerpt":"简体中文 ｜ English komari-traffic-hub（Docker 版） 基于 Komari 探针 的流量统计管理中心，提供： - 📊 Telegram 流量日报 / 周报 / 月报 - 🔥 Top N 流量消耗榜 （支持 /top 6h 、 /top week 等任意时间窗口） - 🤖 Telegram Bot 交互式查询 - 🧭 Web 流量分析面板 - 🐳 Docker / docker-compose 部署 - 🕒 统计口径固定为 北京时间（Asia/Shanghai） - 🧱 适合多节点、长期运行场景 本项目不替代 Komari 官方功能，而是在其基础上补充 长期统计 / 任意时间窗口 Top 榜 / Telegram 查询能力 。 --- ✨ 功能特性 - 日报 / 周报 / 月报 - 在 Web 面板用「每日 / 每周 / 每月 + 时间」配置推送计划 - 支持完整报表或 Top 报表 - 立即发送、最近运行结果和任务历史可在面板查看 - Top 流量消耗榜 - /top ：今日 Top N（上下行合计） - /top 6h ：最近 6 小时 Top - /top week 、 /top month - 交互命令 - /today /week /month - /top [Nh today week month] - /ask 你的问题（或 /ai） - Web 面板 - 总览今日 / 本周 / 本月流量与节点 Top - 查看告警状态，手动检查、静默或恢复告警 - 测试 Telegram 推送，手动发送报表，并使用 AI 问答 - 智能告警 - 节点连续采样失败记录与恢复时长通知 - 最近窗口 / 今日总量 / 单节点流量阈值告警 - 支持冷却时间、静默时段和单独告警 chat - 稳定性 - Komari 节点超时自动跳过，不影响整体报表 - Telegram 网络异常自动重试 - 探针/节点重启自动兜底计数器 - 数据管理 - 历史数据自动压缩归档 - 采样数据用于支持任意 Nh 查询 --- 🧩 依赖说明 - 已部署并可访问的 Komari 面板 - Docker + docker-compose - 一个 Telegram Bot Token - Telegram Chat ID（个人 / 群组） --- 🚀 快速部署（docker-compose） 1️⃣ 创建目录并赋予权限 容器默认以 非 root 用户（uid:gid = 10001:10001） 运行，需要对 data/ 目录具有写权限。 如果启动后日志中出现 PermissionError: [Errno 13] Permission denied: '/data/...' ， 请重新执行上述 chown / chmod 命令后重启容器。 2️⃣ 创建 .env 配置文件 3️⃣ 使用 docker-compose 启动 启动： Web 面板默认访问： http://localhost:8080 推送计划直接在 Web 面板的「推送控制」里配置，由 bot 服务的 listen 进程执行。旧部署如果还保留 cron 服务，可以从 docker-compose.yml 中删除该服务以及 ./crontab:/app/crontab:ro 挂载，避免重复推送。 🧭 Web 面板 Web 面板提供轻量控制台，用于查看总览、节点流量、长期分析、区间 CSV 导出、告警状态、Telegram 推送、AI 问答和系统健康。 - 登录账号： ","default_branch":null,"files":null,"tree":[],"storefront":"/r/wirelouis","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/wirelouis/komari-traffic-hub/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}