nuomiiiii/Lite

Lite 是一款轻量、自托管的服务器监控与运维管理工具。服务端提供 Web 管理界面，Agent 负责采集节点状态、执行延迟与回程线路探测，并在管理员授权后提供远程终端、文件管理和任务执行能力。通过 MCP 代理，还可以让 AI 客户端在授权有效期内管理选定的服务器。

本项目基于 komari-monitor/komari 持续开发，重点改善低配置主控上的数据库占用、历史查询和维护负载，同时提供流量管理、成本中心、备份迁移、接入安全与适配电脑和手机的管理界面。

当前正式版：Lite 2.3.7 · 配套 Agent 2.3.6.0 · 默认主题 1.2.8

使用手册 · 快速开始 · 功能概览 · 升级说明 · Agent · MCP 代理 · 完整更新日志

• 定时任务：可以按北京时间，在选定的服务器上定时远程执行命令，并保留每次输出。任务可以搜索、调整顺序，点进详情查看执行日志。
• 加载：仪表盘时延排行和服务器列表在服务器较多时会更快打开。
• MCP 授权：批准页可以勾选长期授权，默认不勾选。勾选后，这条授权在撤销前一直有效，浏览器登录过期和服务器重启都不会让它失效；不勾选则按所选时长。单次 MCP 终端跟授权到期走，空闲不会结束。最长授权时长可以设到 72 小时。
• 远程终端：单次最长 6 小时，空闲 30 分钟会结束。已打开的会话不再显示服务器标签。
• 仪表盘：新增「续费日历」，按每台服务器到期日汇总。点有到期的日期会列出当天的服务器，点名称进入这台服务器的计费页；设了账单周期的可以点「我已续费」。每日流量明细里，点击服务器名称会进入用量统计。
• 通知：新增「告警渠道」，一种告警可以同时发给多路，也可以都不发送。新增「告警汇总推送」，默认关闭；相同内容会在设定时间内合成一条。
• 延迟监测告警：进一步细分为「丢包告警」和「延迟异常告警」。原有配置会自动迁移至丢包告警；延迟异常支持自适应基线和固定基线。
• 服务器到期时间：可以指定时区，并精确到秒。原有到期日升级后记为北京时间当天 00:00:00。
• 成本中心：服务器国旗跟随手选的国家/地区图标；没手选时仍用自动识别。
• 日志：过长的 IPv6 会自动换行，不再盖住后面的类型和内容。
• 手机端远程终端：复制、粘贴、Tab 旁新增「Ctrl+C」，用来打断正在执行的命令。
• 内置主题：Lite-Theme 1.2.4。首页可按服务器设置探测任务，手机端概览默认关闭。

复制一行即可下载并安装。适用于使用 systemd 的常见 Linux 发行版：

curl -fsSL https://raw.githubusercontent.com/nuomiiiii/lite/main/install-lite.sh -o install-lite.sh && sudo sh install-lite.sh

OpenWrt / iStoreOS 以 root 登录后（通常没有 bash、sudo 或 curl）：

wget -O install-lite.sh https://raw.githubusercontent.com/nuomiiiii/lite/main/install-lite.sh && sh install-lite.sh

安装脚本会按环境选择 systemd 或 procd；满足运行时检查与回退条件后，可使用后台“立即更新”。官方 Linux 包提供 amd64、arm64、386、riscv64 和 loong64，软路由也需匹配其中一种架构。安装完成后访问 http://<服务器或路由器 IP>:27777。正式环境可在后台启用内置 HTTPS，也可以使用反向代理或 Cloudflare Tunnel 接入。详细步骤见Linux 脚本安装手册。

mkdir -p ./data
docker run -d \
  --name lite \
  --restart unless-stopped \
  -p 27777:27777 \
  -v "$(pwd)/data:/app/data" \
  ghcr.io/nuomiiiii/lite:latest

固定使用当前正式版时，将镜像标签改为 ghcr.io/nuomiiiii/lite:2.3.7。

更新 Docker 部署前请先备份 data 目录，然后拉取新镜像并使用原来的端口和数据挂载重新创建容器：

docker pull ghcr.io/nuomiiiii/lite:latest
docker rm -f lite
docker run -d \
  --name lite \
  --restart unless-stopped \
  -p 27777:27777 \
  -v "$(pwd)/data:/app/data" \
  ghcr.io/nuomiiiii/lite:latest

不要在未确认备份的情况下删除宿主机数据目录。

从 Releases 下载与系统架构匹配的文件。正式版提供 Linux 386、amd64、arm64、loong64、riscv64，以及 Windows 386、amd64、arm64 构建。

chmod +x Lite-linux-amd64
./Lite-linux-amd64 server -l 0.0.0.0:27777

默认数据目录为程序工作目录下的 data。

Lite 2.3.7 推荐配套 Lite-agent 2.3.6.0。先在后台添加节点，再打开该节点的“节点配置 → 部署指令”，复制完整命令到目标服务器执行。自动发现注册已下线，新安装和 Docker 重建均使用具体节点的部署指令。

远程终端、文件管理和远程执行需要同时开启 Lite“系统设置 → 通用 → 允许远程管理”与 Agent 本地 --enable-remote-control，新安装默认关闭。进入远程功能时，已启用通行密钥的账号可用通行密钥验证；已启用两步验证但未使用通行密钥时输入当前验证码；未启用时重新输入管理员密码。浏览器远程终端单次最长 6 小时，空闲 30 分钟会结束。

在线配置支持采集间隔、流量重置日、网卡、挂载点、内存缓存计入方式与 GPU 监控的保存、下发和结果确认。远程控制开关等安装选项需要更新节点本地启动参数并重启或重新安装 Agent。安装、日志、更新和卸载步骤见Agent 安装与维护，操作方式见远程终端与文件。

1. 使用配套 Lite-agent，并开启上述站点和 Agent 远程控制开关，再开启“系统设置 → 通用 → 启用 MCP 代理”。
2. 进入“远程管理 → MCP 代理”，复制服务地址，例如 https://monitor.example.com/mcp，添加到支持浏览器授权的 AI 客户端。
3. 客户端发起连接后，在 Lite 中选择允许管理的服务器、授权时长或长期授权，以及可选备注，输入管理员密码、两步验证码或通行密钥，点击“授权并连接”。
4. 回到 AI 客户端执行操作；在 Lite 的“授权详情”和“操作记录”中查看状态、导出记录或撤销授权。

MCP 默认关闭。批准页可以勾选长期授权，默认不勾选。勾选后，这条授权在撤销前一直有效，AI 以 Agent 运行账户的权限执行命令、使用终端和读写文件，Lite 不会逐次确认。到期或撤销会结束相关访问，已完成的修改不会自动回滚。详细配置与排查见MCP 代理与 AI 授权手册。

SQLite 指标库使用紧凑的无损编码和分层保留。压缩不会额外改变已采集指标的数值精度，详细指标和历史汇总继续遵循后台设置的保留周期；流量报告所需的累计值由独立精确账本保存。

数据库缓存、查询并发和后台维护批次会根据主控资源自动调整。已经形成的历史数据堆积会从保存位置继续处理，每批成功后才清理对应旧数据；失败时保留原数据并在后续重试。

这套迁移只适用于 SQLite 指标存储。外置 MySQL 或 PostgreSQL 不会进入 SQLite 指标库迁移，也不会显示对应进度。

1. 停止旧 Lite，备份程序和完整 data 目录。
2. 更新程序或容器，并保持原有 data 挂载不变。
3. 打开管理页面查看迁移进度，确认节点连接、历史曲线、账单与远程功能正常，并保留备份供回退。
4. SQLite 产生的空闲页会继续复用；如需立即把空间归还给磁盘，可在业务低峰期手动执行一次“回收空间”。

上游 1.3.1、1.3.2、1.4.x 以及本分支 2.1.7 至 2.1.11 的 SQLite 指标库会通过同一迁移页面转换为当前格式，原有数据保留周期不会被改回默认值。监控数据固定启用分层降采样，升级时会自动停用旧版低资源模式。

完整步骤与兼容范围见更新与数据库迁移。

一键更新面向官方脚本安装、由 systemd 或 OpenWrt / iStoreOS procd 管理且满足运行时检查的 Linux 实例。更新程序会校验版本、构建标识、大小和 SHA-256，备份当前程序及完整 data，并在新版本启动或健康检查失败时尝试恢复旧程序和更新前数据。

Docker、Windows、不受支持的服务管理方式、外置指标数据库和不满足原子回退条件的目录布局不会启用该入口。更新前仍应保留完整备份；详细限制见 Linux 一键更新与回退。

后端使用 Go 1.26.8，前端构建推荐使用 Node.js 24，与当前发布流程一致。

以下命令编译服务端；完整网页还需要准备后文所述的系统 UI 与主题资源。

git clone https://github.com/nuomiiiii/Lite.git
cd Lite
go build -o Lite
./Lite server -l 0.0.0.0:27777

正式构建会将 Lite Web 作为独立系统 UI 构建，并把产物放入 web/public/systemUI/dist；公开大屏主题则保存在独立的主题目录中。正式版本必须使用与 Lite 相同版本的 Lite Web 标签，可参考仓库内的 GitHub Actions 构建流程。

• 版本发布与完整更新日志
• Lite 文档
• Telegram 群组
• Lite Agent
• Lite Web
• Lite-Theme
• 上游 Komari

感谢上游维护者、Agent 与主题贡献者，以及持续提供测试和反馈的社区用户。本分支保留上游版权与 MIT 许可证。

MIT License