2.2.1

Komari Lite 2.2.1 正式版

重要提示

Important

本版本已经完成系统 Web UI 与原内置默认主题的解耦，并删除原有内置主题，改为我二开的 Nezha 主题（在有其他主题的情况下可删除）。后续系统 UI 独立控制，主题只影响公开大屏。如果您仍需要原有内置主题，请根据链接导入我的独立提取版；该版本我不保证维护，建议使用其他第三方主题：https://github.com/nuomiiiii/komari-Classic

第一次更新

• 发包时间：2026-08-08 06:29（北京时间）

CN2 回程判定

• 优化CN2 GIA/GT回程路由判定算法，新增“CN2 待确认”状态，若现有算法无法进一步断定是属于GIA还是GT时，会提示CN2 待确认，该状态保留上一次已确认线路状态，不累计切线次数，也不触发切换或恢复告警。

仪表盘与告警交互

• 从大屏返回管理仪表盘时，会恢复离开前的完整画面、模块位置和滚动位置，再按照用户设置的刷新间隔静默更新；刷新期间不清空卡片、不重新显示骨架屏，也不会跳回页面顶部。
• 监测告警六个分类支持跳转到现有服务器、延迟任务或回程任务页面并自动应用筛选；点击具体告警可按服务器或任务精确定位，目标页面支持查看和清除当前筛选。
• 账单提醒统一为“已到期或处于提前提醒范围内”的当前待处理状态，并与服务器列表使用相同规则和到期时间排序，不再遗漏已经到期的服务器。
• 三分之一宽度下的告警卡片使用固定对齐的两列三行布局；不同分类的标题、摘要和分隔线保持同一基线，内容不足时仅在下方留白，半宽、全宽和手机端继续自适应。

管理端体验

• 修复手机端主题存在可用更新时，更新标签挤压预览弹窗关闭按钮的问题；标题、更新状态和关闭按钮在窄屏下保持独立且可点击。

Agent 部署指令复制

• 修复 Edge 中显示“复制成功”但系统剪贴板实际没有内容的问题。写入后必须由页面读回并确认内容完全一致，才会显示复制成功。
• 浏览器无法确认写入、读回内容不一致或权限被拒绝时，不再假报成功；页面会自动聚焦并选中部署指令，方便手动复制。
• 手机端在部署指令弹窗内直接显示已确认、未确认或失败状态，避免只依赖容易被忽略的全局提示。

2.2.1 正式版更新

仪表盘配置

• 新增近 15 分钟丢包排行模块。
• 近 15 分钟丢包排行按每台服务器所有监测任务中的最差结果计算；只要存在实际样本且丢包率大于 0% 即进入排行，不再设置不适合低频任务的样本覆盖门槛。全部正常时显示“近 15 分钟网络正常”。
• 延迟抖动根据相邻有效分钟的平均时延差排序；优先比较当前分钟与上一分钟，在采样较少、上报延迟或分钟边界错位时回退到最近一组相邻有效分钟。负数、无效时延和无有效样本的数据不进入排行。
• Top 5 / Top 10 默认单列，Top 15 / Top 20 在合适的宽屏和卡片宽度下自动双列，手机端保持单列；三分之一、二分之一和整行宽度下均保持统一密度、完整数量和文字可读性。
• 修复“今日实时流量”“每日计费流量”图表左侧刻度被裁切的问题，长刻度在桌面端和手机端均可完整显示，且不牺牲字号和可读性。

跳转与加载体验

• 排行跳转会读取当前启用主题声明的 UUID 路由，不与特定主题绑定；未声明对应导航能力的第三方主题会安全回退到服务器详情页。
• 平均时延和延迟抖动排行进入服务器网络总览，避免多个探测任务的综合结果错误落入某一个具体任务；近 15 分钟丢包排行进入该服务器丢包最差的监测任务。
• 仪表盘设置、摘要和图表增加按管理员账号、模块组合及 Top 数量隔离的会话快照。刷新页面或从公开大屏返回时，会立即恢复上一帧完整内容，再在后台静默更新，不再清空卡片或重复显示骨架屏。
• 静默刷新期间保留现有卡片和图表，新结果完整返回后再原地替换；请求失败时继续保留旧数据，不产生二次闪烁。会话快照仅保存最终响应，最长保留 10 分钟。

刷新与缓存

• “实时概览刷新”和“历史图表刷新”默认均调整为 30s。
• 实时概览新增 15s；历史图表提供 15s / 30s / 60s / 120s，移除 300s。已保存的旧 300s 配置会安全归一为 120s。
• 在线状态、CPU、内存和磁盘等实时模块跟随实时概览周期；流量、时延趋势、平均时延、延迟抖动和丢包排行等历史模块跟随历史图表周期。
• 修复前后端缓存使用不同时间基准导致新数据未按设置周期刷新的问题；选择 15s 后不再被旧缓存额外延迟到一分钟或两分钟。
• 同一模块的并发请求只计算一次，缓存仅保存有界的最终响应，不缓存原始指标点，也不写入数据库。

查询与历史数据

• 优化仪表盘/公开大屏数据处理流程，修正历史指标清理逻辑，减少重复查询和临时内存占用。
• 六小时延迟趋势按有效样本数加权，不直接平均各节点平均值；负数时延、全丢包产生的无效时延和空样本继续排除。
• 公开接口保持现有 JSON 字段、层级、数据类型、时间顺序、标签、点数限制、空数据填充和权限过滤不变，当前主题及第三方主题无需为批量查询做适配。

主题与系统界面

• 系统 Web UI 与默认主题解耦，后续系统 UI 独立控制，主题只影响公开大屏，不再影响管理后台、远程终端等系统页面。
• 默认集成 Nezha 主题，保留独立更新和删除能力。
• 主题管理增加最后一个主题保护，系统中必须至少保留一个可用主题，避免公开大屏因主题全部删除而无法访问。
• 原经典主题拆分为独立的 komari-Classic 主题包，可单独安装和更新。
• 修复主题导航入口、Logo、国家/地区图标及其他静态资源在不同部署路径下缺失的问题。
• 修正未初始化、404 及主题异常场景的页面提示；系统未初始化时访问公开大屏会直接进入初始化流程。

设置与交互修复

• 新节点在“编辑信息”中首次设置流量统计方式时默认选择“总和”。
• 远程终端节点卡片改为整卡点击，桌面端和手机端均可从任意位置进入；与服务器列表保持一致，在新分页打开终端，并移除卡片内的 IP 复制按钮以避免点击冲突。
• 修复仪表盘设置页面过度下滑、布局预览空隙、不同分辨率下内容显示不全，以及 PC 三列布局卡片底边错位的问题。
• 服务器删除确认框会加粗显示目标服务器名称，降低误删风险。
• 修正内置 HTTPS 延迟关闭时状态先于监听器停止的问题，使界面状态与真实服务生命周期保持一致。
• 保留 2.2.0 的 HTTPS 引用策略修复，允许第三方图片资源接收来源站点，同时不暴露完整页面路径。

发布信息

• 正式版发布时间：2026-08-07 21:57（北京时间）
• Komari 构建号：07e8284
• Komari 与 Komari Web 版本：2.2.1

Docker

docker pull ghcr.io/nuomiiiii/komari:2.2.1

docker pull 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

已有安装可在管理后台执行在线更新，也可以下载对应架构的单文件程序替换后重启。更新前请先备份数据库和配置文件。