Skip to content

2.1.8

Choose a tag to compare

View all tags
@github-actions github-actions released this 26 Jul 04:50
· 0 commits to 91e43f5498bcf62e7d51bfae35671b041284e134 since this release
2.1.8
1d66ce1

重要提示

Important

**2.1.7 上游删除数据 BUG：**上游删除服务器或延迟监测任务时，可能遗留相关配置、告警、任务结果和历史指标。本次更新后首次启动会自动清理这些遗留数据。升级并确认 Komari 正常启动后，建议先备份 data 目录，再在业务低峰期进入后台数据库管理手动执行一次“回收空间”，将清理后产生的空闲数据库页归还给磁盘。回收期间可能短暂增加 CPU 和磁盘占用，但不会删除保留周期内的有效数据。

Important

**2.1.7 SQLite V3/V4 迁移提示：**指标库迁移涉及本地 SQLite 结构调整，建议手动更新。迁移期间请保持服务运行，不要强制停止进程。当前版本兼容上游 1.1.x、1.2.x、1.3.x 旧结构、2.1.x V3 结构以及早期 V4 结构，并会在校验失败时保留原结构、回滚本次迁移。该自动转换仅适用于本地 SQLite；外置 MySQL/PostgreSQL 不执行 SQLite V3/V4 转换。

Important

**2.1.6 Agent Token 安全修复：**请先升级 Komari Server/Web，再升级 Agent；升级完成后按节点顺序重置 Agent Token，并在 24 小时内完成全部节点的 Token 重置。

2.1.8 同版本第 3 次更新

更新时间：2026-07-27 13:57:57（北京时间）

  • 同步上游最新快照，更新公共 Ping 任务 API 新增 weight 字段，保持向后兼容，主题和其他客户端可读取任务权重进行排序或加权分发。
  • Favicon 响应禁止浏览器继续使用旧缓存，后台上传或恢复默认图标后会立即刷新当前预览和浏览器标签页图标，修复自定义图标生效慢的问题。
  • “恢复默认 Favicon”改为可重复执行，即使当前没有自定义图标也会正常恢复默认状态。

2.1.8 同版本第 2 次更新

更新时间：2026-07-27 13:14:30（北京时间）

  • 将 Komari 默认网页图标、站点图标与 PWA 图标统一替换为新版透明底 Komari Logo。
  • 回归上游 1.2.6 移除的内置 Cloudflare Tunnel，恢复后台“反向代理”设置页面及 Tunnel 配置入口。
  • 支持保存或移除 Cloudflare Tunnel Token，并展示运行状态、启动、停止和运行日志；已配置的 Tunnel 会在 Komari 重启后自动恢复运行。
  • Cloudflare Tunnel Token 使用加密配置保存，通用设置接口不会返回明文或加密后的 Token 内容，相关管理操作写入审计记录。
  • Docker 镜像按系统架构内置匹配的 cloudflared，无需在容器中另行安装。

2.1.8 同版本第 1 次更新

更新时间：2026-07-26 17:26:43（北京时间）

  • 数据库维护区域新增“运行状态”，每 10 秒自动刷新指标压缩与 SQLite WAL 检查点状态。
  • 展示当前指标、压缩进度、本轮汇总桶数量、运行临时文件、最近成功截断时间和预计下次截断时间。
  • 统一运行临时文件统计口径，上方概览和下方运行状态均按 WAL + SHM 显示，并提供 WAL、SHM 明细。
  • SQLite checkpoint 失败后自动重试；连续失败 1～2 次显示“等待截断”，连续失败 3 次或压缩周期连续失败 2 轮显示“需要关注”。
  • 异常状态展示最近错误；checkpoint 恢复成功后自动清除失败次数和错误信息。
  • 精简正常状态文案为“正常”，并完成桌面端与移动端布局适配。
  • 运行状态仅保存在内存中，不新增数据库表、不额外执行 checkpoint，也不会改变数据精度和现有压缩周期。

2.1.8 更新内容

  • 汇总历史压缩优化，在低配置单核设备上降低压缩处理开销，同时继续压缩历史数据。
  • 完善 SQLite V3/V4 迁移：逐点校验原始数据、保留浮点数位级精度，迁移失败自动回滚并保留原数据结构。
  • 增加旧 digest 迁移数量提示，便于升级时确认迁移范围。
  • 保留百分位查询能力，不降低指标和流量账本的数据精度。

Bug 修复

  • 修复 digest 迁移校验不完整时可能继续提交的问题。
  • 修复 SQLite 迁移遇到异常数据时无法安全回退的问题。
  • 修复旧 V3 数据迁移后继续写入、压缩和查询的兼容性问题。

部署

Docker

docker pull ghcr.io/nuomiiiii/komari:2.1.8

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
Assets 12
Loading