Komari Lite 2.2.3（分支）：基于上游 Komari 的轻量化与运维体验优化

本项目基于开源项目 komari-monitor/komari 持续二次开发和维护。它不是脱离上游重新做一套监控系统，而是在保留上游节点监控、Agent 采集、延迟探测和公开主题等核心能力与使用习惯的基础上，继续针对低配置主控、数据库占用、后台交互、流量与告警、Agent 管理和多端运维体验进行优化。

服务端仍然提供统一的 Web 管理界面，Agent 负责采集节点状态、执行延迟与回程线路探测，并在管理员授权后提供远程终端、文件管理和任务执行能力。

Lite 分支的重点，是把这些能力在长期运行、低配部署和日常维护场景下做得更完整、更稳定。

目前最新稳定版为 Komari Lite 2.2.3，建议搭配 Agent 2.2.0.2 使用。

在上游基础上，Lite 分支主要优化了这些体验

节点在线状态与自动重连

Komari Lite 会通过连接心跳维护节点在线状态，不会因为采集间隔较长或探测任务类型不同而误判离线。

Agent 2.2.0.2 在 WebSocket 被关闭或写入卡住后会自动重连，不需要依赖手动重启服务恢复连接。

新服务器自动整理位置

“系统设置 → 通用”新增了 “新增服务器自动排序” 开关，默认关闭。

开启后，新节点第一次上报并识别出国家或地区时，会优先排到同一分组、同一国家或地区的最后一台服务器后面；如果所有服务器都没有分组，则按国家或地区整理新节点。没有匹配对象时，节点仍保留创建时的位置。

这个功能只影响之后加入的新服务器，不会打乱已经整理好的节点顺序。

适合长期值守的告警管理

负载通知新增 “当前告警” 视图，可以集中查看正在触发的告警，并按规则或服务器搜索。

某台服务器暂时无法处理时，可以只对 “这条规则下的这台服务器” 静默 24 小时、3 天、7 天或永久静默。静默只暂停消息推送，不会停止检测，也不会影响仪表盘、当前告警和监控图表。

离线通知、延迟监测告警和流量定时报告还可以保存 “新服务器默认配置”。以后新增节点时可以自动套用规则，同时不会修改已有服务器的配置。

更快、更稳定的后台切换

后台顶栏和侧栏在页面代码加载期间会保持显示，加载状态只出现在内容区域。节点列表、节点详情和延迟任务会复用已经获取的数据，减少页面切换时的重复等待和框架闪白。

登录后，常用页面会根据浏览器空闲时段和当前网络状况低优先级预热。缓存仍然有效时会直接复用，减少首次切换等待，同时避免和当前操作争抢带宽。

可靠的上传、迁移和更新

备份恢复、首次安装恢复和主题上传采用分块传输，网络中断时只需要重试失败部分。上传进度会先稳定到达 100%，再进入服务端处理阶段，取消和完成状态也更清晰。

数据库迁移现已覆盖上游 1.3.1、1.3.2 和 1.4.x 的指标布局。迁移在 SQLite 事务中执行，失败会自动回滚；如果同时检测到两套完整的上游布局，系统会拒绝误迁移。

Linux 直装的安装与在线更新也加强了失败回退，启用内置 HTTPS 后不再因为本机证书名称校验而误判更新失败。

可配置的监控仪表盘

在首发仪表盘功能的基础上，Lite 分支为管理后台增加了可配置仪表盘。可以选择默认、网络质量、资源与容量、流量与账单、运维值守或低配精简等预制布局，也可以自行调整模块开关、顺序、宽度、刷新周期和 Top 5/10/15/20 排行。

可展示的内容包括服务器状态、CPU、内存、磁盘、流量、计费流量、平均时延、延迟抖动、近 15 分钟丢包、回程线路、告警和存储健康等。

延迟、丢包与回程线路监测

Komari Lite 支持 IPv4/IPv6 延迟任务、历史曲线、平均时延、延迟抖动和丢包排行，也能对电信、联通、移动回程线路进行识别（首发）。

当前可识别 CMIN2、CMI、CMNET、CUG VIP、CUG 优化、9929、4837、CN2 GIA、CN2 GT 和 163 等线路，并通过确认次数与冷却时间降低瞬时波动造成的误告警。

流量、限额与账单信息

每台服务器可以保存价格、货币、流量额度、流量重置日和不同的计费方式。仪表盘可以查看单日计费流量排行与月度趋势，通知系统还支持流量告警以及日、周、月定时报告。

远程终端、文件和任务管理

Lite 分支继续完善了上游 Agent 体系下的远程管理体验。在 Agent 支持且管理员主动发起的前提下，可以通过后台打开多标签 Web 终端、管理文件、执行远程任务和使用 Docker 管理能力。

这些入口受管理员登录、双因素认证和短时会话限制，不会替代或修改服务器原有的 SSH、防火墙和远程连接配置。

公开主题与管理后台互不干扰

从 2.2.1 开始，系统 Web UI 与公开大屏主题已经解耦。后台与公开主题可以分别更新，切换公开主题也不会改变管理后台和远程终端。

主题市场支持预览缓存、多语言名称、作者和描述，并可以在主题设置中直接选择节点或 Ping 任务。PWA 会实时使用后台设置的站点名称、描述和 favicon。

面向低配置主控的数据管理

SQLite 指标库采用紧凑无损编码和分层保留。短期数据保留更细的采样，较旧数据逐层转换为分钟、五分钟和小时级摘要，原始点 15 分钟 → 1 分钟桶 48 小时 → 5 分钟桶 14 天。

后台还提供数据库占用明细、运行诊断、WAL 维护、手动空间回收、完整备份恢复和仅配置导出，方便长期运行和迁移。

适合哪些使用场景

• 手上有多台 VPS，希望统一查看在线状态、资源和流量。
• 需要长期观察跨地区延迟、丢包和回程线路变化。
• 希望告警、流量报告和远程运维集中在同一个后台。
• 主控配置不高，但仍需要保留可查询的历史数据。
• 重视数据自托管，希望自己掌握监控数据、凭据和备份。
• 需要兼顾桌面端和手机端的日常管理。

快速部署

Docker

新部署默认拉取 latest，并务必持久化 /app/data：

  ghcr.io/nuomiiiii/komari:latest

Linux 一键安装

curl -fsSL https://raw.githubusercontent.com/nuomiiiii/komari/main/install-komari.sh -o install-komari.sh && chmod +x install-komari.sh && sudo ./install-komari.sh

首次进入页面后创建管理员账号，再从后台添加服务器并使用生成的命令安装 Agent。

升级或从上游 Komari 切换到 Lite 分支前，请先备份完整 data 目录。Docker 更新时必须保持原来的数据卷挂载，不要把新容器误启动成全新实例。上游数据库迁移支持范围请以当前 Release 和使用手册为准。

项目地址

• Komari Lite：https://github.com/nuomiiiii/komari
• 最新稳定版：https://github.com/nuomiiiii/komari/releases/latest
• 使用手册：https://lite.komari.wiki/
• Komari Agent：https://github.com/nuomiiiii/komari-agent
• Telegram 群组：https://t.me/komari_lite

Komari Lite 的二开方向不是脱离上游堆出另一套复杂系统，而是在轻量、自托管的前提下，围绕真实使用中的性能、数据、交互和运维问题持续优化。

感谢上游 Komari 作者和社区贡献者提供的项目基础，也感谢参与 Lite 分支开发、测试和问题反馈的用户。本分支保留上游版权并继续遵循 MIT 许可证。

如果你已经在使用 Komari，希望获得更适合低配置主控的数据库与查询表现、更完整的仪表盘和告警管理，以及持续增强的 Agent 运维体验，可以从 Komari Lite 2.2.3 稳定版开始了解。