2.1.9

2.1.9 更新内容

• 指标库采用新的无损 digest 编码，在不降低指标精度、百分位精度和累计流量精度的前提下降低数据库占用。
• 启用分层 digest 接力。
• 压缩与迁移按固定时间分片执行并支持中断续跑，降低低配服务器长事务和 WAL 波动。
• 新增数据库迁移进度页面，启动阶段可直接查看当前阶段、进度和已处理数据量。
• 兼容从上游 1.1.x、1.2.x、1.3.x、Komari 2.1.x V3 及早期 V4 指标库升级，并保留用户原有的指标持久化天数。
• 修复部分由早期 2.1.8-fix 或边界迁移状态升级时，因 cannot losslessly hand off digest 导致指标库初始化失败、Komari 无法启动的问题。
• 当历史细分层覆盖不足、无法无损重建粗分层 digest 时，本轮迁移会保留原汇总块并延期接力，不再阻断服务启动；后续满足条件时会继续处理。

2.1.9 同版本第 2 次更新（北京时间 2026-07-28 03:06）

• 修复从完整 V4 指标库升级至 2.1.9 时未进入迁移进度页的问题；首次升级现在会显示 digest 分层接力进度，完成后持久记录迁移状态，后续启动不会重复进入。
• 完善 V4 迁移收尾与自动回收模式切换；迁移失败仍可在进度页重试，不修改原有指标持久化天数，也不改变原始指标、累计流量或百分位精度。
• 已覆盖上游 1.1.x、1.2.5、1.2.5-fix2、1.2.6、1.2.7、1.3.0，1.2.8 普通版、1.2.8-fix，以及自有 2.1.x V3、2.1.8、2.1.8-fix 的数据库升级路径。
• 修复边界 digest 数据无法无损接力时阻断服务启动的问题；无法安全接力的历史块会原样保留，并在条件满足后继续处理。

部署

Docker

docker pull ghcr.io/nuomiiiii/komari:2.1.9

Docker 镜像支持 Linux amd64 和 arm64。

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