已安装Wazuh Agent但未在仪表盘显示的问题求助

DevOps 小满

2026-7-7

排查Wazuh Agent未在仪表盘显示的问题

以下是针对Ubuntu系统Agent安装启动后未出现在Wazuh仪表盘的排查步骤：

确认Agent运行状态
执行命令检查Agent是否正常运行：
```
sudo systemctl status wazuh-agent
```
重点看输出中是否显示active (running)状态，若有报错信息，优先根据提示修复。
验证Agent配置正确性
编辑Agent配置文件，确保指向正确的Wazuh Manager：
```
sudo nano /var/ossec/etc/ossec.conf
```
找到<client>区块，确认<server>标签内的Manager IP/域名无误，<port>默认1514需与Manager配置匹配。修改后重启Agent：
```
sudo systemctl restart wazuh-agent
```
检查Agent与Manager的网络连通性
- 测试Manager IP可达性：
```
ping <wazuh-manager-ip>
```
- 测试1514端口连通性（Wazuh默认使用UDP，同时检查TCP）：
```
nc -zv <wazuh-manager-ip> 1514
nc -zvu <wazuh-manager-ip> 1514
```
若不通，检查两端防火墙/安全组是否开放1514端口，Agent端是否允许出站该端口流量。
确认Agent已在Manager端注册
在Wazuh Manager机器上执行命令查看已注册Agent列表：
```
/var/ossec/bin/manage_agents -l
```
若未找到目标Agent，重新完成注册流程：
1. 在Manager生成Agent密钥：
```
/var/ossec/bin/manage_agents -a <agent-ip> -n <agent-hostname>
```
2. 在Agent机器导入密钥：
```
/var/ossec/bin/manage_agents -i <生成的密钥字符串>
```
3. 重启Agent：
```
sudo systemctl restart wazuh-agent
```
查看日志定位问题
- 查看Agent端运行日志：
```
tail -f /var/ossec/logs/ossec.log
```
  查找包含connection、error、auth的条目，定位连接失败或认证问题。
- 查看Manager端日志：
```
tail -f /var/ossec/logs/ossec.log
```
  查找是否有Agent连接请求的记录或拒绝信息。
刷新仪表盘等待同步
手动刷新Wazuh仪表盘页面，或等待2-5分钟，Agent与Manager完成同步后通常会显示在列表中。