2.1.12

本版本重点改善长期运行后的数据库占用、查询响应和低性能主控下的稳定性，同时完善后台仪表盘、导航布局与远程终端体验。

第五次同版本更新

• 发包时间：2026-08-04 18:13（北京时间）
• Komari 构建号：f2f37e0
• 优化指标存储日常 IO：SQLite 在没有过期数据时快速返回；没有过期记录的指标序列不再重复解码、重写或开启无效事务，降低磁盘读写与 CPU 消耗。
• 感谢上游 komari-monitor/komari。本次基于上游实现思路移植动态指标写入队列容量、单指标负载告警查询、RAM/Swap/磁盘容量来源修正、Ping Agent 排序与完整批量排序校验，并结合当前分支的数据模型、聚合语义和接口行为完成兼容调整。
• 继续统一电脑端与手机端后台 UI：电脑端使用高信息密度列表，手机端使用自适应卡片；统一服务器、延迟监测、回程线路、远程管理、通知告警、日志与设置页面的字号、间距、按钮、圆角、阴影、状态和分页布局。
• 服务器列表独立展示 Agent 版本并收紧行高，重新分配备注与账单宽度；修复从服务器名称打开详情时 IPv4 被默认聚焦或选中的问题。
• 新增全局“列表默认分页”设置，入口位于“系统设置 - 通用”，支持每页 10、50 或 100 条，并同步应用到后台所有分页列表。
• 优化手机端设置页和状态标签布局，移除日志等页面的冗余摘要；回程线路监测分页移入列表框，手机端任务按钮保持同一行。
• 修复部分手机浏览器和已安装 Web App 无法连接远程终端的问题，并保持管理员会话与一次性票据校验，不降低远程会话安全性。
• 优化手机端远程终端的软键盘、英文输入、中文输入法组合文字和页面缩放行为；统一右键菜单“全选”图标，同时保持电脑端终端布局与输入行为不受影响。
• 修复 iPhone Safari 与移动端 Edge 中拖动远程终端会带动浏览器页面的问题；触控拖动现在只滚动终端历史记录，轻触仍可正常聚焦输入。

第四次同版本更新

• 发包时间：2026-08-03 15:35（北京时间）
• Komari 构建号：f1f4b78
• 全面优化后台电脑端与手机端 UI；双端采用不同的信息布局，电脑端使用列表，手机端使用自适应卡片，分别兼顾信息密度与触控可读性。
• 统一节点列表、延迟监测、回程线路、远程执行、通知与告警等页面的字号、间距、按钮、分页和移动端卡片交互。
• 修复手机端最后一张卡片与分页分隔线黏连的问题。
• 仪表盘新增回程线路监测信息；未配置或当前无任务时显示“暂无正在执行的回程线路监测任务”。

第三次同版本更新

• 发包时间：2026-08-03 00:27（北京时间）
• Komari 构建号：29e6d98
• 修复手机端刷新管理页面时侧边栏会短暂显示后再收回的问题，移动端首次渲染即可正确识别屏幕宽度，不影响电脑端侧边栏状态。
• 优化电脑端和手机端版本入口的主题色、尺寸与对齐方式，手机端继续使用保留正文可见的半遮盖导航布局。

第二次同版本更新

• 发包时间：2026-08-02 21:37（北京时间）
• Komari 构建号：5cb6d0d
• 新增内置 HTTPS，可从服务器证书路径读取证书，支持 IPv4/IPv6 监听、HTTP 自动跳转 HTTPS 与 HSTS；反向代理、内置 HTTPS 和 Cloudflare Tunnel 的设置入口重新整理。
• 完整备份与恢复已适配当前数据库结构并保留历史监测数据，同时新增“仅导出配置”，兼容当前分支、旧版本和上游现有结构的迁移。
• 服务器支持手动修正国家或地区、设置重置流量额度以及校准当前计费周期流量；仪表盘、公共主题接口、流量告警、日报、周报和月报统一采用校准后的统计结果，并在下一个流量重置日自动清零校准差额。
• 改进多标签页连续打开不同服务器远程终端时的会话管理，兼容 Cloudflare、反向代理、两步验证和离线节点；文件管理已有批量选择增加右键下载，Agent 拒绝等提示补齐中文。
• 独立登录页、后台入口、主题管理与升级弹窗统一界面和交互，修复重复加载、主题切换衔接和 GitHub Markdown 更新内容显示问题。

第一次同版本更新

• 发包时间：2026-07-31 22:28（北京时间）
• 修复全丢包 Ping 历史桶因没有有效延迟摘要而无法继续分层接力的问题。
• 改为按桶内实际采样总数与丢包数判断，只有整桶全部丢包时才允许无延迟摘要接力；只要存在一条有效延迟，摘要缺失仍会严格拦截并保留原数据。

数据库存储优化

实测占用对比

对比版本	同一份已填满 7 天数据的实际样本	变化
Komari 2.1.11 正式版（构建 3faffcd）	21.84 MiB	对比基线
Komari 2.1.12 正式版	18.81 MiB	减少 3.03 MiB，约 13.9%

以上数据来自同一份数据库升级前后的实际对比，不是按理论模型估算；服务器数量、探测任务、数据波动和保留周期不同，实际缩减比例也会有所变化。官方 1.3.2 主要优化了部分告警查询和批处理内存分配，未改变数据库存储格式，也没有可直接对照的官方缩减数据，因此不虚构百分比。

• 高效存储，无损精准：引入新一代无损摘要编码技术，在大幅减少历史数据冗余占用的同时，确保监控数据精度丝毫未减。
• 架构精简，无缝兼容：统一了延迟与丢包数据的底层存储结构，消除了同一探测任务的重复记录。更重要的是，本次优化对上层完全透明，原有接口与数据提取方式均保持不变。
• 真正的分层生命周期管理：告别过去长期堆砌不同精度数据的旧状，历史数据现在实现了真正的分层接力。原始采样、分钟级、五分钟级及小时级数据将依据保留规则逐层流转与交接。
• 配置智能迁移：新版本已统一启用数据降采样，并移除了旧有的低资源模式。升级过程中，系统会自动兼容并处理旧版本中的相关配置，保障平滑过渡。

数据库性能与低性能主控

• 历史查询改为按页面实际需要读取数据，延迟统计通过一次读取统一生成，减少大数据库下的重复扫描和等待。
• 根据主控可用内存、CPU 核心数和容器资源限制自动调整数据库缓存与查询并发，兼顾 512 MiB、单核设备、ARM64 慢速主控和普通多核服务器。
• 历史压缩与数据接力改为分批执行，每批完成后主动让实时监控数据优先写入，避免维护任务长时间占用数据库。
• 已经形成的历史数据堆积会从保存位置自动继续处理；每批成功后才清理对应旧数据，失败只回滚当前批次，不需要清库或重新迁移。
• WAL 维护采用短时快速尝试和定期完整重试，失败时保留已经提交的数据与完整 WAL，避免慢速磁盘反复长时间阻塞。
• 空间回收改为分批执行；手动回收在数据库繁忙时会等待当前任务完成，不再直接失败。
• 数据库页面会按实际执行时间更新压缩、截断和下一次维护状态，不再显示已经过期的预计时间。

后台仪表盘与加载体验

• 新增后台仪表盘并设为管理端默认首页，可集中查看服务器在线率、离线节点、今日实时上传与下载、今日计费流量、最近一个月每日计费流量和数据库文件组成。
• 只有设置了价格的服务器才计入计费流量；免费或未设置价格的服务器仍统计上传与下载，但不计入计费汇总。日报、周报和月报采用相同口径。
• 仪表盘汇总结果缓存 15 秒，减少频繁刷新带来的数据库压力。

远程终端

• 改进连续打开多个远程终端时的连接管理，自动清理残留连接并识别失效会话，避免前几个终端正常、后续终端无法打开。
• 修复 PWA 图标重复缓存冲突，兼容 Cloudflare Tunnel、Docker 和常见反向代理环境下的 WebSocket 校验。
• 从服务器列表进入终端时使用轻量状态请求，不再额外建立容易被反向代理拒绝的旧状态连接。
• 所选节点会保留在终端页面地址中，刷新、两步验证、连续打开、多标签页及离线节点场景下都不会丢失或串到其他服务器；节点信息不会发送给 Cloudflare、反向代理或服务端。

后台界面整理

• 重整后台导航，将监测、远程管理、通知与告警、外观与主题、系统设置、账户与安全按用途归类。
• 数据库功能统一收纳到“数据与存储”，通过“存储概览、监控数据、迁移与维护”集中查看容量、配置、迁移进度和空间维护。
• 统一仪表盘、服务器、监测、回程监测、远程管理、通知、主题、设置、日志、关于、账户、登录、会话管理和流量报告的标题字号、间距与页面布局。
• 收窄电脑端侧边栏并减少多余留白，手机端保留合适的触控区域，同时优化菜单、页签、数据库信息和长列表布局。
• 默认主题设置补齐简体中文、繁体中文、英文、日文和印尼文显示，切换后台语言后不再混用其他语言。

升级迁移与数据安全

• 兼容上游旧版本、上游 1.3.1、1.3.2，以及 Komari 2.1.7 至 2.1.11 的数据库升级。
• 数据库结构升级统一通过迁移页面展示当前阶段、处理进度和错误信息，迁移失败会完整回滚并保留原数据。
• 保留用户原有的数据保留天数、查询接口、历史数据精度和持久化设置，升级后无需重新配置监控任务。
• 压缩、分层接力、WAL 截断或空间回收失败时不会删除尚未安全接力的数据，后续会在条件满足后继续处理。

发布信息

• 正式版首次发布时间：2026-07-31 20:54（北京时间）

Docker

docker pull ghcr.io/nuomiiiii/komari:2.1.12

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