版本与功能范围

当前文档基线

组件	文档版本	状态	说明
Lite	2.3.7	已发布	服务端、管理后台、定时任务、MCP 代理、数据迁移与公共接口
Lite-agent	2.3.6.0	已发布	节点采集、远程控制、文件传输优化、MCP 完整管理与回程线路探测
Lite-Theme	1.2.4	已发布	默认公开大屏主题

手册按 Lite 2.3.7 的当前功能和上述配套版本编写。具体构建标识以 Lite“关于”页面和 GitHub Release 中的七位构建码为准；排查问题时应同时提供版本号和构建码。

使用 Snapshot 时，应以对应 Release 的测试说明为补充，并在更新前备份完整 data 目录。

Lite 2.3.7、Agent 2.3.6.0 与 Theme 1.2.4 重点变化

• 定时任务：新增“远程管理 → 定时任务”，支持按间隔、每天、每周和每月执行命令，每周可选多个星期；日历定时按北京时间计算。支持立即执行、启用与停用、任务排序，以及各节点输出和退出码查询。保存后无需保持浏览器打开，关闭远程管理或相关账号安全变更会停用任务。
• 账号与安全：保留通行密钥、头像、全局自动登出时长和登录会话管理；头像也可通过公开主题接口按登录状态返回。
• 服务器管理：账单到期时间支持 IANA 时区、本地日期和时分秒；列表、公开主题和大屏按到期瞬间向上取整显示剩余天数。自动续费按服务商当地时区推进，处理夏令时跳时，并避免并发编辑覆盖较新的到期时间。
• 成本中心：费用概览显示到期当地时间和估算剩余价值；删除节点后不再计入当前汇总，历史账目仍保留。汇率、原始币种和地区覆盖值继续按资费版本保存。
• 通知与告警：支持统一渠道或按事件分配多个渠道，并可在 1–3600 秒内汇总相同内容的告警。登录通知及流量日报、周报、月报单独发送。渠道参数与告警分配分别保存，测试只发给当前编辑的渠道。延迟异常仍支持固定或自适应基线，恢复按统计窗口的平均时延判定。
• 仪表盘：新增“续费日历”，按服务器各自的到期时区展示每日到期节点，可进入账单页或立即续费。告警概览与时延、抖动、丢包排行继续按服务器和 Ping 任务定位。
• MCP 代理与 AI 授权：临时授权最长可调至 72 小时，默认最长仍为 24 小时；新增默认不勾选的长期授权，退出登录和正常重启后保留，仍支持撤销。
• API 与 RPC2：公开节点字段新增 expiry_timezone、有限资费的 remaining_value 和 remaining_value_currency；已登录的 public:getMe 可返回 avatar_url。API Key 不能签发或使用远程授权，也不能访问备份、主题、账号和节点 Token 等敏感操作。
• Agent 安装与维护：Lite-agent 2.3.6.0 优化远程文件上传和下载；配合当前 Lite 与后台构建，可使用二进制传输和并行上传。上游迁移、精确流量重置、HTTP 压缩回退及 Windows 安装修复继续保留。
• 备份与空间维护：完整备份和配置备份继续包含头像，Passkey 数据随主数据库保存；删除历史记录后如需立即降低主数据库占用，应使用“回收空间”。
• 反向代理与 Tunnel：Docker 镜像不内置 cloudflared，后台 Tunnel 管理需要挂载主机二进制并设置 LITE_CLOUDFLARED_BIN，或单独运行 cloudflared 容器。
• 主题管理：默认 Lite-Theme 更新到 1.2.4，支持为各节点选择和排序首页探测任务，每台最多 4 个；手机端概览可单独开启，默认关闭。卡片剩余价值和登录后管理员头像继续保留；主题开发补充 serverpingtasks 配置类型。

从旧版本沿用的行为

• 外部监控数据库：支持 MySQL、MariaDB 和 PostgreSQL，在“数据与存储 → 监控数据”填写连接串即可切换，已有历史可在“迁移与维护”中搬运。主数据库继续使用本地 SQLite。

• 自动发现新节点的接口和后台入口已经下线；新安装及 Docker 重建都使用后台为具体节点生成的普通部署命令。

• 远程终端、文件管理、远程执行和定时任务统一受站点开关、Agent 本地开关及重新验证保护。浏览器短期授权绑定当前管理员登录会话；终端与文件管理共用授权范围，远程执行及定时任务的管理操作使用 exec 范围。已保存并启用的定时任务由服务端继续调度，不依赖浏览器会话。

• 主题上传、更新、GitHub 安装和市场安装统一限制为 128 MiB，并加强网络下载地址检查。

• 完整备份会携带恢复加密两步验证数据所需的实例密钥，恢复前会校验数据库与密钥是否匹配。

• 管理员密码改用 Argon2id，旧密码会在成功登录后自动升级；2FA Secret 加密保存，并阻止同一验证码重复使用。

• 主题常用的 common:getNodes 不再返回 Agent 版本、部署状态和远程管理状态等后台字段。

• 远程执行可避免同一任务因重复投递而再次运行，并能在 Agent 异常退出后报告未知执行状态；旧自动发现安装只读取已有身份文件，不再注册新节点。

与上游的关系

Lite 基于 komari-monitor/komari 持续开发，但数据库结构、后台界面、Agent 更新源和部分公共接口兼容逻辑已经不同。

本手册统一使用以下口径：

• “与上游一致”表示当前 Lite 已按实际实现核对，所述行为可按同一方式使用。
• “上游兼容”只表示文中明确列出的版本、数据或接口可以迁移或调用，不代表镜像、数据库和后台实现完全相同。
• “Lite-agent”表示 nuomiiiii/Lite-agent 独立仓库的配套 Agent。当前只支持协议 2，不代表兼容上游或旧版 Agent。
• “本项目官方脚本”表示 nuomiiiii/lite 仓库发布的安装脚本，不是上游仓库的脚本。
• Lite 与上游确有差异时，页面会直接标注差异和适用范围，不要求读者自行判断。

不要混用两个项目的 Docker 镜像地址，也不要让两个项目同时读写同一份数据目录。从上游切换到 Lite 前必须备份；当前已适配的迁移来源见更新与数据库迁移。第三方主题和外部集成应使用公共接口，不应直接依赖内部数据库结构。