Komari 1.2.6：全新可定制、可扩展统计图表，支持外部数据库

Komari 1.2.6 带来了一次面向监控数据体系的大型更新。

1.2.6 对后端监控数据存储进行了完整迁移，虽然版本内置了迁移与兼容设计，但这仍是一次涉及数据结构和存储路径的重大变更。

强烈建议所有用户在升级前完整备份 Komari 的数据目录和现有数据库。

升级后，请留意后台的“监控数据库”设置页，确认当前数据库连接、迁移状态和指标保留策略符合预期。

升级后首次启动时，Komari 会自动迁移已有监控数据到新的指标数据库。迁移耗时取决于历史数据量，数据较多时可能需要一段时间；

本次更新包括：

全新的实例统计图表，支持自定义图表布局、拖拽排序、隐藏指标和全局默认模板。

统计图表不再局限于固定的历史字段，而是逐步转向基于指标的绘制方式，为后续接入更多监控指标和自定义展示提供基础。

全新的实例统计图表

支持自定义图表布局、拖拽排序。

自定义图表曲线

支持多种数据采样方式

支持指定时间范围查询

可单独定制每一项系统指标

完整更新日志：

主要更新内容

• 安全增强：强制对敏感 RPC 操作进行双因素认证（2FA），防止越权调用


• 数据库维护：新增数据库 Vacuum 和存储大小查询 API，支持手动回收空间


• 监控数据迁移：历史监控数据（records、gpu_records、ping_records）从旧表迁移至 Metric Store，支持 SQLite/MySQL/PostgreSQL 后端


• 身份模型重构：引入 Principal 主体模型替代简单角色字符串，严格分离 Agent 与 Admin 权限


• 安装体验改进：安装脚本支持 TUI（whiptail/dialog）及稳定版/快照版通道选择


• 移除 Cloudflare 集成：移除内置 Cloudflare Tunnel 和 Cloudflare Access OAuth 支持，相关依赖一并清理


• 启动生命周期重写：采用显式 App 结构体分阶段启动，提高可维护性和错误处理

Bug修复

• 节点顺序丢失：修复 common:getNodes RPC 返回结果不保留原始排序的问题


• 主题路径遍历：修复 DeleteTheme、UpdateTheme、SetTheme 操作未校验路径，可被利用读取任意文件


• Telegram 错误描述：非 200 响应时返回 API 错误描述而非仅状态码，便于排查问题

其他

• 移除旧定时压缩逻辑，由 Metric Store 内置 rollup 保留策略替代


• 前端构建流程拆分为独立 GitHub Action，支持构建缓存和复用


• 增加 Snapshot 自动发布工作流，支持快照版本发布


• Metric Store 聚合查询新增 PreserveSeries 选项，保留标签维度输出独立序列


• 修复若干 Metric Store 并发竞争和迁移进度记录问题