多台 VPS 一屏尽览：Komari 轻量监控面板部署实录

前言：手上有几台分散的 VPS 和一台家里的小主机，每次巡检都要挨个 ssh 上去看负载，散乱且容易漏。试了几个监控方案后选了 Komari——单二进制、资源占用极低、agent 上报模式。本文记录面板 + 多 agent 的完整部署和三个踩坑点。

一、为什么选 Komari

监控面板的选型维度其实是三个：资源占用、部署复杂度、告警能力。Netdata 功能最强但单机就吃几百 MB；Zabbix 是企业级的重；我的需求只是"一屏看到所有机器的 CPU/内存/磁盘/网络，掉线能知道"——Komari 单二进制 + agent 上报模式刚好，面板常驻内存几十 MB，VPS 上跑毫无压力。

二、面板部署（Docker 优先）

docker compose up -d 后访问面板端口，初始管理员密码在容器日志里拿：

登录后第一件事：改密码、然后在面板里添加节点——每个节点会生成一个带 UUID 的 agent 安装命令。

三、Agent 安装与注册

在每台被监控机器上执行面板生成的安装命令，本质是下载 agent 二进制并以 systemd 服务运行：

agent 只出不进（主动向面板上报），被监控机不需要开任何入站端口——这是它比"面板 ssh 到各机采集"的方案安全得多的关键：受监控面为零。

四、三个踩坑点

1. 面板反代后 agent 连不上

用 Nginx 反代面板时，WebSocket 升级头没配，agent 的实时上报通道全部 502：

加上 Upgrade/Connection 两行立刻恢复——所有 WebSocket 类服务反代都要检查这两行。

2. 防火墙只放行必要端口

面板机只需要放行 443（反代）；agent 机的出站保持默认即可。曾把面板的 25774 直接暴露公网，被扫描器持续探测——反代 + 面板仅监听 127.0.0.1 才是正确姿势。

3. agent 掉线的排查顺序

面板显示某台掉线时，按顺序查：systemctl status komari-agent（服务是否活着）→ agent 日志里的上报错误（证书/网络）→ 面板侧重启容器。九成是 agent 机器换过 IP 或证书过期。

五、结果

五台机器一屏尽览，CPU/内存/磁盘/流量实时曲线，掉线面板顶栏红条提示。面板 + 5 个 agent 的总内存占用不到 100MB。

六、总结

监控方案的选择逻辑：先明确"我需要什么、不需要什么"——我需要一屏聚合和掉线感知，不需要告警矩阵和海量插件。按需选型，Komari 这类轻量方案就是最优解。下一步把面板的告警接上企业微信机器人，掉线主动推消息。

（完）环境：Ubuntu 22.04 / Docker / Nginx / Komari / 2026-10 实测