Komari NetForecast 流量预测插件

Auth:猫饭       Date:2026/11/20       Cat:代码       Word:共1205字       Views:37

面向 Komari 监控面板 的全节点网络流量智能预测与多模式计费限额告警插件。

NetForecast Dashboard Preview

TL;DR:根据 7 天内流量新增量加权平均预测每个月流量是否超限,支持 Komari 内部节点配置的计费类型和限制。(因为 Komari 的数据库并不保存每日流量,所以安装插件之后才能开始统计,要准确预测需要至少安装 7 天后)。


🌟 核心功能亮点

  • 📊 账单周期全景监控:以节点每月重置日为时间基准覆盖完整计费月,单页平铺展示全节点的每日进出站增量堆叠柱状图与计费累计走势。
  • ⚡ 当日流量实时呈现:自适应计算今日 00:00 截至当前时刻的实时增量,精准反映当天最新消耗(Tooltip 标注 今日实时)。
  • ⚖️ 5 种计费统计模式自适应:
    • sum:双向求和(入站 + 出站)
    • max:双向取大(MAX(入站, 出站))
    • min:双向取小(MIN(入站, 出站))
    • upload / up:仅计出站(出网流量)
    • download / down:仅计入站(入网流量)
    • 图表智能视觉区分:计费流量高亮显示,非计费流量自动半透明弱化。
  • 🗓️ 账单周期自动对齐:自动同步节点到期日(expired_at)作为每月重置日(如 8 号到期即每月 8 号重置,未配置时自动按自然月 1 号重置)。
  • 🌐 时区自由配置 (Timezone Offset):支持在插件设置中自定义统计基准时区(默认 UTC+8 北京时间,偏移量可配置)。日切片与重置日计算完全自适应配置时区,彻底免除修改 VPS 系统或 Docker 容器时区的繁琐操作。
  • 🔮 智能耗尽推算与阈值告警:基于 7 天加权移动均速平滑推算重置日总消耗,提前预测流量超标并在耗尽时提供精确倒计时天数。
  • 🪟 前台自适应悬浮小组件 (Floating Widget):
    • 轻量微交互:右下角常驻 48×48 方形状态图标,正常显示翠绿光边,节点告警时智能切换为红色脉冲警报光圈。
    • 自由拖拽与位置记忆:支持原生触控与鼠标平滑拖拽停靠,松手后自动记忆位置(localStorage 持久化),刷新不跑偏。
    • 单节点详情自动聚焦:访问 https://your-komari/instance/:uuid 实例页时,浮窗自动聚焦展示当前节点指标;同时保留全部药丸(📌 当前、全部、预警、安全、免额),点击任意药丸可无缝切换全局筛选。
    • 卡片一键直达详情:点击小组件内的任意节点卡片,智能适配 Hash/Path 路由一键跳转进入对应实例的 /instance/:uuid 详情页。
    • 后台自动免打扰:进入 /admin/* 后台管理区域时自动静默隐藏,不在管理视图中产生任何视觉干扰;支持在插件设置中一键开启/关闭。
  • 💨 SWR 本地秒开与骨架屏:废除全屏阻断遮罩,页面刷新 0 毫秒瞬间还原图表与数据,后台无感静默同步;首次访问呈现平滑微光骨架屏,保障界面极致流畅。
  • ⚙️ 直连核心数据库:在卡片右上角点击「设置限额」,直接持久化回写至 Komari 核心数据库,无插件层私有缓存。
  • 💾 极轻量日结存储:后台仅按天归结每日一条极简时序,内置 90 天自动滑动清理,百台节点总存储不足 1 MB。

除非注明,猫饭文章均为原创,本文地址 https://maofun.com/3741.html,转载请以链接形式注明出处。

作者: 简介:

《Komari NetForecast 流量预测插件》留言数:0

发表留言