先说问题:机器多了,状态不能靠「登上去看看」
自建服务上了规模之后,手里往往不止一台机器:主力 VPS 跑业务、家里小主机跑影音、还有一两台吃灰的小鸡做备份节点。平时风平浪静,直到某天服务打不开,登上机器才发现磁盘三天前就满了——这种教训,经历过一次就够了。
监控要解决的其实是两个问题:现在怎么样(实时状态)和刚才发生了什么(历史曲线)。本篇主角 Komari 是一个开源的轻量级服务器监控:一个 Web 面板 + 每台机器一个 Agent,汇总展示 CPU、内存、磁盘、网络流量与在线状态,附带延迟 Ping 任务和历史图表。它的定位是「个人多节点看板」,部署五分钟,资源占用小到可以忽略,正合本系列的自建场景。
选型对比:Komari 放在什么位置
| 方案 | 部署成本 | 资源占用 | 适合场景 |
|---|---|---|---|
| Komari | 低,单容器面板 + 脚本装 Agent | 极低 | 个人多台 VPS 状态汇总 |
| 哪吒监控 | 低,生态成熟 | 低 | 节点多、需要丰富告警与任务 |
| Zabbix | 高,组件多 | 中高 | 企业级、成百上千节点 |
| Prometheus + Grafana | 中高,要写配置 | 中 | 指标深挖、自定义大盘 |
本站 Docker 系列写过 Prometheus 方案,那是「指标系统」的打法;Komari 是「看板」的打法。本篇不纠结谁更强:个人自建的监控第一诉求是所有机器一眼看全、异常有历史可查,Komari 用最低成本满足这两点。服务本身是否可用(HTTP 层面)则交给第 4 篇的 Uptime Kuma,两者分工不同、互不替代。
部署面板:一份 Compose
按系列规范装在 /opt/apps/komari/,官方镜像来自 GitHub Container Registry:
services: komari: image: ghcr.io/komari-monitor/komari:latest container_name: komari restart: unless-stopped ports: - "25774:25774" volumes: - ./data:/app/datacd /opt/apps/komaridocker compose up -dKomari 的全部数据(节点信息、监控历史、账号配置)都存在 /app/data 里,已经按规范挂到本目录的 data/ 下,备份时整个目录带走即可。面板默认端口 25774。
首次访问 http://你的IP:25774 进入初始化:设置管理员用户名和密码。这个密码就是所有服务器状态的总钥匙,必须用独立强密码,不要和任何其他服务复用——密码该怎么管,第 11 篇的 Vaultwarden 会给出答案,先从不复用做起。
套上域名:通过 NPM 反代
裸奔的 IP:25774 只是临时入口。按第 2 篇 Nginx Proxy Manager:所有自建服务的统一入口 的流程,给 Komari 加一条 Proxy Host:子域名如 status.example.com,转发到 172.17.0.1:25774,申请证书并 Force SSL。Komari 面板有实时数据推送,添加时记得打开 Websockets Support,否则实时曲线可能不刷新。
反代完成后,宿主机防火墙只放行 80/443/SSH,25774 不再对公网开放。注意一个细节:Agent 与面板之间的通信也走这个域名(下一节),所以这个子域名等于监控系统的生命线,DNS 解析要保持稳定。
接入节点:Agent 安装
面板装好只是空壳,数据来自每台机器上的 Agent。接入流程是「面板生成命令,节点执行命令」:
- 登录面板后台,进入节点管理,添加一个节点,给它起个能认出来的名字(如
主力-HK、家里-NAS)。 - 面板会为该节点生成一条专属的 Agent 安装命令,形如:
bash <(curl -sL https://raw.githubusercontent.com/komari-monitor/komari-agent/main/install.sh) -e https://status.example.com -t <该节点的令牌>- 到被监控的机器上以 root 执行这条命令。脚本会下载 Agent、写入配置并注册为系统服务,开机自启、掉线自动重连。
- 回到面板,节点状态变绿,实时数据开始上报。
命令里两个参数:-e 是面板地址(Endpoint),-t 是节点令牌(Token)。令牌等同于该节点的身份凭证,不要截图外发、不要写进公开仓库;怀疑泄露时在面板里删除该节点重新添加,旧令牌立即失效。
Agent 的通信方向是「节点主动连面板」,所以被监控机器不需要开放任何入站端口,NAT 后面的家用设备也能接入,只要它能访问面板域名。这一点让 Komari 特别适合「VPS + 家里小主机」的混合舰队。
面板能看什么
- 实时状态:每台节点的 CPU、内存、磁盘、网络速率与在线状态,首页卡片式排布,多台机器一屏看全。
- 历史曲线:负载、流量等指标的历史图表——排障时先看这里,「服务是几点开始变慢的」往往曲线上写着答案。
- 流量统计:按节点统计流量消耗,对有月流量额度的 VPS 尤其重要,超额前心里有数。
- Ping 任务:可以配置从各节点向指定目标发起的延迟探测,用来观察不同线路到某个地址的延迟与丢包,比如多台机器到你家宽带、或到常用服务的线路质量。
公开访问方面,面板支持以访客模式展示(不登录也能看状态页)。是否开放看个人:状态页方便随时瞄一眼,但也等于公开了你的机器配置与在线规律,节点备注里不要写真实 IP、机房账号等敏感信息,名字用代号即可。
多节点接入的实务要点
时间要同步。 各节点系统时间偏差会让曲线对不齐、历史数据错位。所有机器开启 NTP 自动同步(timedatectl set-ntp true),面板机尤其要准。
命名先行统一。 节点一旦多起来,「new-server-3」这种名字会让你在凌晨排障时崩溃。建议一开始就定好规则:用途-地区,如 业务-香港、影音-家里、备份-洛杉矶。
面板本身也要被监控。 Komari 挂了不会有人通知你——它就是通知系统的一部分解。把面板域名加进第 4 篇 Uptime Kuma:服务可用性监控与公开状态页 的监控列表,用外部视角盯它。
告警别指望面板单打独斗。 Komari 擅长展示,告警与通知策略(离线多久算故障、通知发给谁、半夜要不要吵醒人)是第 5 篇 监控告警实战:通知、值班与故障处理流程 的主题,两篇配合才算完整的监控闭环。
排障:节点不上线怎么办
按这个顺序查,基本能覆盖九成情况:
- Agent 服务在不在跑:在节点上执行
systemctl status komari-agent(服务名以安装脚本实际注册为准),不在跑就看它的日志报错。 - 端点通不通:在节点上
curl -v https://status.example.com,看 DNS 解析、证书、连通性哪一步断。面板若刚换过证书或反代配置,这里最容易出问题。 - 令牌对不对:命令是不是从当前节点的详情里复制的、粘贴时有没有少字符。删了重加节点是最快的验证办法。
- 时间对不对:节点时间偏差过大可能导致连接被拒,先
date对一眼。
面板侧问题则先看容器日志:cd /opt/apps/komari && docker compose logs -f,再确认 data/ 目录可写、磁盘没满——监控数据写不进去时面板会表现得像「所有节点都离线」。
WARNING监控系统最危险的失效模式不是报错,而是「静默死亡」:面板进程还在,但数据停了,你看着昨天的绿色状态以为一切正常。养成习惯:每次打开面板先扫一眼数据更新时间;同时用 Uptime Kuma 从外部盯住面板本身,让两个系统互相守夜。
常见问题
Q:Agent 占用多少资源? 极小,常态 CPU 接近 0、内存十几 MB 量级,老机器、便宜小鸡都能放心装。
Q:节点离线多久面板会标记离线? Agent 保持长连接上报,断连后很快就会显示离线。是否要为此发通知、等多久发,属于告警策略问题,放到第 5 篇统一设计,避免短暂抖动半夜连环轰炸。
Q:Windows 或 NAS 能接入吗? Agent 有多平台版本,官方仓库提供对应安装方式;NAS 若支持 SSH 与脚本执行一般也能装。实在装不了 Agent 的设备,用第 4 篇的可用性监控盯它的服务端口即可。
Q:数据保留多久?磁盘会不会被监控数据吃满?
Komari 是轻量设计,历史数据体积增长缓慢。稳妥起见把 data/ 纳入第 11 篇的备份与容量巡检范围,磁盘告警线设在 80%,别等满了才发现。
小结
Komari 的部署可以概括为:一份 Compose 起面板、NPM 套上域名证书、每台机器执行一条面板生成的命令接入 Agent。十分钟之后,你的所有服务器从「各自为政」变成「一屏看全」,历史曲线和流量统计也都有了。但监控的价值一半在看、另一半在报——服务真挂了,谁在什么时候以什么方式通知你?下一篇先用 Uptime Kuma 把「服务可用性」这条线补上,再往后一篇专门讲告警与处理流程。