Komari Agent 显示离线？新手排查与解决方案指南

最近在折腾服务器监控工具的时候，发现有不少新手朋友第一次用 Komari 都会遇到这样尴尬的情况：明明 Agent 安装成功了，控制面板里也能显示服务器的 IP 地址，但是状态栏那一栏却一直顽固地显示“离线”。看着有连接信息的 IP 却无法正常监控，确实挺让人抓狂的。

如果你也正好踩了这个坑，别急着卸载重装，咱们按顺序排查一下，通常几分钟就能搞定。

1. 确认服务进程是否真的在跑

首先，最基础的一步是检查客户端的服务进程是否启动了。有时候安装脚本执行完毕并没有报错，但服务因为各种原因（比如内存不足、权限问题）并没有真正运行起来。

使用 systemctl 命令检查 Komari 服务进程是否在运行

• Linux 用户：可以使用 systemctl status komari 或者 ps aux | grep komari 来查看进程状态。如果是 dead 或没有输出，说明服务挂了，尝试用启动命令重启一下。
• Docker 用户：检查容器是否在运行，输入 docker ps 看看对应的容器状态是 Up 还是 Exited。如果是 Exited，用 docker logs <容器名> 查看具体的报错日志。

2. 端口是否被阻断？

检查防火墙和安全组规则，确保通信端口已放行

Komari 需要特定的端口来与控制端通信。很多时候显示 IP 说明网络有一瞬间是通的，但心跳包发不出去就会导致判定为离线。

• 防火墙/安全组：去你的 VPS 控制面板后台，检查安全组规则，确认 Komari 所需的通信端口（通常是 TCP 协议下的特定端口）是否放行。如果没放行，入站和出站规则都要加上。
• 服务器内部防火墙：如果你开启了 ufw、firewalld 或者 iptables，记得也要在内部放行端口。新手经常漏掉这一步，导致外部通了内部被拦。

3. 配置一致性检查

这是很多人容易忽视的地方。安装 Agent 时，系统会生成一个唯一的配置文件或 Token。

• Token/Key 错误：确保你在服务器端安装时填写的 Key 与你在 Komari 控制面板获取的是完全一致的。多一个空格或者少一个字符都会导致认证失败，显示离线。
• 填写地址：有些部署方式需要手动填写上报的服务器地址。如果你填的是内网 IP 或者错误的域名，Agent 自然找不到回家的路。

4. 网络环境与 IP 变动

如果你的服务器是动态 IP 或者位于复杂的网络环境（如 NAT VPS、CGNAT），可能会出现 IP 显示存在但实际连接不稳定的情况。

• 尝试在服务器上 ping 一下 Komari 的通信节点，看网络延迟和丢包情况如何。
• 如果是国内服务器，访问境外节点可能会因为网络波动导致连接超时，这种情况下可能需要考虑设置代理或者更换节点。

5. 看日志！看日志！看日志！

重要的事情说三遍。如果以上步骤都做了还是不行，日志是唯一的真相。

• 日志里会明确写出是因为连接超时、认证失败还是证书错误。根据日志里的报错信息去搜索，解决方案通常是现成的。

总结

Komari 是个不错的监控工具，新手遇到“有 IP 但离线”的情况，90% 都是因为防火墙端口没开或者配置 Key 填错。按照上面的流程顺一遍，基本都能解决问题。搞定之后，看着那个绿色的小圆点亮起来，是不是心里瞬间舒坦了？