Komari 轻量服务器监控：Docker 一键部署 + 与 Uptime Kuma 区别详解

手里几台 VPS、NAS、小主机，CPU 飙了、磁盘满了、流量跑超了都不知道？今天介绍 Komari：一款轻量开源的服务器监控面板，MIT 协议免费，Docker 一条命令跑起来，多台机器的资源状态一屏看清。顺带讲清楚它和 Uptime Kuma 到底有什么区别、该怎么选。

Komari 是什么？

Komari（komari-monitor/komari）是一个自托管的服务器监控工具，Go 语言开发，GitHub 6000+ Star，MIT 开源协议，完全免费无付费版。

它的工作模式和“哪吒探针”类似：面板端 + Agent 端。你在 NAS 或一台 VPS 上部署面板（Dashboard），然后在每台要监控的机器上装一个轻量 Agent，Agent 会把 CPU、内存、磁盘、网络、流量、负载等指标实时上报到面板，打开网页就能看到所有机器的状态。

核心特点：

• 极轻量：Agent 资源占用极小，面板默认 SQLite，不用额外装数据库；
• 秒级实时：官方称监控数据按秒级间隔展示，机器状态变化立刻可见；
• 自托管：数据只留在你自己的服务器上，不经过第三方；
• 可玩性高：支持自定义主题和插件，社区有主题市场，监控页可以做得很好看；
• 附带 Web 终端：面板里可以直接打开被控机的终端，排查问题不用再 SSH。

Docker 部署面板：一分钟搞定

官方镜像在 GitHub Container Registry，默认端口 25774，数据目录 /app/data，不配数据库就用 SQLite：

mkdir -p ./data && docker run -d \
  -p 25774:25774 \
  -v $(pwd)/data:/app/data \
  --name komari \
  --restart unless-stopped \
  ghcr.io/komari-monitor/komari:latest

更推荐 Compose，方便以后升级：

services:
  komari:
    image: ghcr.io/komari-monitor/komari:latest
    container_name: komari
    restart: unless-stopped
    ports:
      - "25774:25774"
    volumes:
      - ./data:/app/data

启动后打开 http://服务器IP:25774，首次访问会进入安装向导：创建管理员账号、设置站点名称。./data 目录存着账号、配置和监控记录，记得定期备份。

群晖 NAS（Container Manager）部署步骤

1. Container Manager → 项目 → 新增，项目名填 komari，路径选一个顺手的共享文件夹；
2. 把上面的 Compose 内容粘贴进 docker-compose.yml；
3. 下一步完成，等镜像拉取完、容器状态变为运行中；
4. 浏览器打开 http://群晖IP:25774，按向导创建管理员账号。

端口提醒：25774 记得在群晖防火墙放行（仅内网访问的话不用映射到公网）。

接入被控机：装 Agent

面板跑起来只是第一步，Komari 的精髓是 Agent 上报。流程：

1. 登录面板后台，进入节点管理，添加一个节点（填个名字，比如“腾讯云-上海”）；
2. 面板会生成一条一键安装命令，里面带了面板地址（endpoint）和节点 Token；
3. 去被控机上以 root 执行这条命令，Agent 就会自动下载、安装并连回面板；
4. 回到面板，节点显示在线，CPU/内存/磁盘/流量曲线开始滚动。

Agent 本身也支持容器化（ghcr.io/komari-monitor/komari-agent，参数 -e 面板地址 -t Token），但注意：容器里的 Agent 只能看到容器视角的资源，想监控整台宿主机还是建议用一键脚本直接装在宿主机上。

装完后的效果大概是这样（官方仪表盘实拍）：

核心功能速览

• 节点总览：所有机器在线状态、CPU/内存/磁盘/流量、累计流量一屏展示；
• 历史曲线：每台机器的资源使用历史图表，半夜谁在偷跑流量一目了然；
• Web 终端：面板里直接进被控机终端，应急排查不用找 SSH 客户端；
• 通知告警：节点掉线、资源超限可以推送通知（支持 Telegram 等常见渠道）；
• 主题市场：监控页支持换主题，做成公开的服务器状态页也很好看。

重点：Komari 和 Uptime Kuma 有什么区别？

这是被问得最多的问题。两者都是“监控”，但监控的东西完全不是一回事：

一句话总结：Komari 回答“机器健不健康”，Uptime Kuma 回答“服务活没活”。

举个例子：你的博客打不开了——Uptime Kuma 会立刻告诉你“网站 Down 了”；而 Komari 会告诉你“这台 VPS 的内存 98%、磁盘满了”，帮你定位为什么挂了。一个管“现象”，一个管“原因”。

该怎么选？

• 只想知道网站/服务有没有挂 → Uptime Kuma 就够了，部署最简单；
• 手里有多台 VPS/NAS，想看资源用量、流量统计 → Komari；
• 都想要 → 两个都跑，它们是互补关系不是替代关系。很多人的标准组合就是：Uptime Kuma 做存活告警 + 状态页，Komari 做资源总览。

（本站后续也会出一篇 Uptime Kuma 的部署教程，敬请期待。）

远程访问与安全建议

• 面板默认 HTTP，不要直接把 25774 暴露到公网。需要外网看监控页，走反代 + HTTPS（Lucky / Nginx Proxy Manager 都行）；
• Agent 连面板走的是出站连接，被控机不用开入站端口，NAT 后面的机器也能接；
• 管理员设强密码，./data 目录定期备份——监控历史丢了是小事，账号配置丢了重建麻烦。

总结

Komari 是一款“装完就回不去”的小工具：面板一条 Docker 命令，被控机一条安装命令，几台机器的 CPU、内存、流量就全收进一个仪表盘了。配合 Uptime Kuma，一个管机器健康、一个管服务存活，个人服务器的监控体系就算齐活了。

花二十分钟搭起来，以后半夜收到告警，打开面板就知道是哪台机器在作妖。

相关阅读：

• Dockhand 开源 Docker 可视化管理面板：群晖 NAS 一键部署实战
• 群晖 Docker 容器升级失败怎么办：备份、回滚与日志排查完整指南
• 群晖 NAS 使用 Docker 部署 Lolia FRP 实现多隧道内网穿透
• Lucky 反代宝塔面板 — Docker macvlan + bridge 双网络解决方案