Wazuh 单机部署实战:用一台主机搭起 HIDS + SIEM
结论先行: 中小环境里,"有日志但没人看"比"没日志"更危险——你会以为自己有可见性。Wazuh 的价值在于用一台主机 + 一个agent就能同时覆盖 HIDS(文件完整性、进程、注册表、审计日志)和 SIEM(采集、解码、规则匹配、告警)。但部署成败并不取决于装不装得上,而取决于三件事:容量估算是否留够余量、agent 注册端口是否放通、以及第一周有没有把噪声调下去。装完不调规则,你会得到一个每天几万条无用告警的"告警垃圾场",三周后所有人都会忽略它。
本文以 Wazuh 4.14 分支为例,全部命令与端口来自官方文档,可直接在生产预演环境复现。合规提示:本文仅用于授权环境的安全监测体系搭建。
1. 先算容量,再谈安装
Wazuh 官方 quickstart 明确说明:把 Wazuh server、Wazuh indexer、Wazuh dashboard 三个中心组件装在同一台主机上,适合监控不超过 100 个端点、保留 90 天可查询告警的场景。推荐硬件如下(来自官方 quickstart 表格):
| 受管 agent 数 | CPU | 内存 | 存储(90 天) |
|---|---|---|---|
| 1–25 | 4 vCPU | 8 GiB | 50 GB |
| 26–50 | 8 vCPU | 8 GiB | 100 GB |
| 51–100 | 8 vCPU | 8 GiB | 200 GB |
这里有个最容易搞混的点:上面这张表是"推荐值",不是硬门槛。 安装助手实际强制校验的最低门槛是 4 GB 内存 + 2 核,不满足时会直接报 minimum hardware requirements of 4Gb of RAM and 2 CPU cores 并退出(可以用 -i/--ignore 跳过检查,但强烈不建议在有真实数据的主机上这么做)。也就是说,低于 8 GiB 依然装得上,只是 indexer 是基于 OpenSearch 的组件、吃内存很凶,内存不足会直接表现为查询慢、索引阻塞甚至 OOM。
结论是:把 8 GiB 当底线,把 4 GB 当"能装但别放生产"的下限。 虚拟机上装之前,先跑一遍确认:
free -h # 内存建议 >= 8 GiB
nproc # 建议 >= 4
df -h / # 根分区剩余空间sudo apt-get update && sudo apt-get upgrade -y支持的系统以官方列表为准:RHEL 7/8/9/10、CentOS Stream 10、Amazon Linux 2/2023、Ubuntu 16.04–24.04,需要 x86_64 或 ARM64。如果你的生产环境是 AlmaLinux 9,属于 RHEL 9 兼容分支,可以按 RHEL 9 处理(存疑项建议先用测试机验证一次)。
2. 安装助手 all-in-one 部署
Wazuh 提供了官方的 installation assistant,它会自动完成证书生成、indexer 初始化、安全集群初始化、dashboard 安装等一整套动作。下载脚本时URL 中的 4.14 是发布分支号,需要与你要部署的版本一致:
curl -sO https://packages.wazuh.com/4.14/wazuh-install.sh && sudo bash ./wazuh-install.sh -a-a 即 all-in-one(也可写 --all-in-one),表示三个中心组件装在本机。整个过程通常 5–15 分钟,取决于带宽与磁盘性能。完成后终端会打印:
INFO: --- Summary ---
INFO: You can access the web interface https://<WAZUH_DASHBOARD_IP_ADDRESS>
User: admin
Password: <ADMIN_PASSWORD>
INFO: Installation finished.这一步的密码只显示一次。 忘了不用重装,凭据写在脚本同目录生成的归档里:
sudo tar -O -xvf wazuh-install-files.tar wazuh-install-files/wazuh-passwords.txt装错想重来,安装助手支持回滚:
sudo bash ./wazuh-install.sh -u # 卸载中心组件3. 端口与防火墙:agent 连不上的 90% 原因
Wazuh 涉及的端口固定且有限,上线前一次性规划清楚:
| 端口 | 协议 | 用途 |
|---|---|---|
| 443 | TCP | Wazuh dashboard(Web 界面) |
| 1514 | TCP(可选 UDP) | agent 上报事件 |
| 1515 | TCP | agent 注册(enrollment) |
| 1516 | TCP | Wazuh 集群内部通信(单机不需要) |
| 55000 | TCP | Wazuh server REST API |
| 9200 | TCP | Wazuh indexer REST API |
| 514 | UDP/TCP | Syslog 采集(默认关闭) |
生产环境的正确做法是只对 agent 网段开放 1514/1515,55000 与 9200 不对外——dashboard 在本机访问这两个端口即可。以 firewalld 为例:
firewall-cmd --permanent --add-port=1514-1515/tcp --add-port=443/tcp
firewall-cmd --reload以 ufw 为例:
ufw allow 443/tcp && ufw allow from 10.0.0.0/24 to any port 1514,1515 proto tcp
ufw reload经验:agent 显示 Disconnected 但日志里没有明确报错时,先查 1515/1514 是否被主机防火墙或云安全组拦掉,这比查 Wazuh 自身配置快得多。
4. 装完先做两件事:验活与冻结版本
三个(4.x 上还有 filebeat)服务的健康状态:
sudo systemctl status wazuh-manager --no-pager
sudo systemctl status wazuh-indexer --no-pager
sudo systemctl status wazuh-dashboard --no-pager
sudo systemctl status filebeat --no-pager从 Wazuh 自己的控制入口看内部守护进程是否齐全,比看 systemd 更直观:
sudo /var/ossec/bin/wazuh-control status输出应包含 wazuh-modulesd、wazuh-monitord、wazuh-logcollector、wazuh-remoted、wazuh-syscheckd、wazuh-analysisd、wazuh-execd、wazuh-db、wazuh-authd 均为 running。再验证 indexer 与 API:
curl -k -u admin:'<ADMIN_PASSWORD>' https://localhost:9200第二步容易被忽略:装完立刻禁用 Wazuh 软件源。 官方文档(Recommended Action)明确建议这么做,避免无意间的自动升级把整个环境搞崩:
# RHEL 系
sed -i "s/^enabled=1/enabled=0/" /etc/yum.repos.d/wazuh.repo5. 注册第一个 agent
agent 必须先配好官方仓库,再安装——WAZUH_MANAGER 通过环境变量在安装时写入配置:
# DEB 系(Ubuntu/Debian)
curl -s https://packages.wazuh.com/key/GPG-KEY-WAZUH | gpg --no-default-keyring \
--keyring gnupg-ring:/usr/share/keyrings/wazuh.gpg --import && chmod 644 /usr/share/keyrings/wazuh.gpg
echo "deb [signed-by=/usr/share/keyrings/wazuh.gpg] https://packages.wazuh.com/4.x/apt/ stable main" \
| tee -a /etc/apt/sources.list.d/wazuh.list
apt-get update
WAZUH_MANAGER='10.0.0.10' apt-get install wazuh-agent
systemctl daemon-reload && systemctl enable --now wazuh-agentRPM 系(RHEL/AlmaLinux)配置 wazuh.repo 后执行 WAZUH_MANAGER='10.0.0.10' yum install wazuh-agent。Windows 端点用 MSI 静默安装,注意 WAZUH_MANAGER 必须是可被 agent 解析的地址:
msiexec.exe /i wazuh-agent-4.14.4-1.msi /q WAZUH_MANAGER="10.0.0.10"
NET START WazuhSvc注册完成后在 dashboard 的 Agents 页面状态应为 Active。建议给 agent 起规范化的 name(如 web-prod-01),否则后续规则里按主机名做分组和例外会非常痛苦。
6. 三类模块要开,一类规则要定
Wazuh 开箱即用的几个模块,直接决定了你能不能真的查到东西:
- FIM(File Integrity Monitoring,内部模块名 syscheck):监控关键目录(
/etc、/usr/bin、Web 根目录、Windows 的启动项与计划任务目录)的新增、修改、删除。 - SCA(Security Configuration Assessment):按 CIS 基线做配置合规检查,用于发现"没打补丁、没开审计"这类问题。
- Vulnerability Detector:基于已安装软件清单匹配 CVE,输出受影响资产与漏洞等级。
规则层面,Wazuh 内置规则已经带上了 MITRE ATT&CK 映射,不需要你自己编。例如 SSH 相关(规则 ID 均可从官方 ruleset 查证):
| 规则 ID | 触发条件 | 等级 | ATT&CK |
|---|---|---|---|
| 5715 | SSH 认证成功 | 3 | T1078 / T1021 |
| 5710 | SSH 使用不存在的用户登录 | 5 | T1110 |
| 5712 | 8 次不存在用户登录 / 120 秒(同源 IP) | 10 | T1110 |
| 5720 | 同源 IP 多次 SSH 认证失败 | 10 | T1110 |
调规则的正确姿势是先验证再上线,而不是直接改生产。Wazuh 提供了离线测试工具,可以在不产生真实告警的前提下确认某条日志会命中哪条规则:
sudo /var/ossec/bin/wazuh-logtest粘贴一行 syslog 进去,Phase 3 会输出命中的 rule id、level、groups 与 mitre.id。例如一行 Invalid user blimey from 18.18.18.18 会命中 5710,等级 5,映射 T1110;重复到第 8 次时会升级为 5712(等级 10)。自定义规则同样先用 wazuh-logtest 验证,再写入 /var/ossec/etc/rules/local_rules.xml。
7. 上线第一周:把噪声压下去
规则验证通过只是起点。真正决定这套系统能不能被运维用起来的,是第一周的调优:
- 按告警量排序找噪声源。等级 3 以下、每天上千条的规则,要么调
ignore,要么降到不推通知。 - 给白名单留位置。备份软件、监控采集、定时任务产生的文件变更会大量触发 FIM(如规则 550"文件校验和被修改"),用
<ignore>精确排除具体路径,不要粗暴地关闭整个目录监控。 - 分级推送。等级 7 以下进 dashboard 供检索即可;等级 10 以上才推人。把所有告警都推到群里,等于把所有告警都关掉。
- 主动响应(Active Response)要谨慎开。它能自动断开源 IP、删除恶意文件,但配错会在业务高峰期误伤。建议先在非生产环境用真实攻击流量验证,再逐条放开。
8. 小结
Wazuh 单机部署的技术门槛其实不高:一条安装命令、三个端口、一次 wazuh-logtest。真正拉开差距的是流程——先估算容量、装完冻结版本、注册 agent 时统一命名、上线后按告警量调规则。如果你所在的网络刚经历过勒索或横向移动事件,Wazuh 至少能补上"事后能复盘"这一环:FIM 会告诉你哪些文件在被批量改写,安全日志规则会告诉你哪个账户在什么时间、从哪台主机做了网络登录。可见性不是安全,但它是所有安全动作的前提。
参考来源
- Wazuh 官方文档 · Requirements(各部署形态的最低/推荐硬件,all-in-one 最低 4 GB / 2 核、推荐 16 GB / 8 核):https://documentation.wazuh.com/current/installation-guide/requirements.html
- Wazuh 官方文档 · Quickstart(安装命令、推荐硬件、端口、密码提取、卸载选项):https://documentation.wazuh.com/current/quickstart.html
- Wazuh 官方文档 · Testing decoders and rules(
wazuh-logtest用法与 5710/5712 规则行为):https://documentation.wazuh.com/current/user-manual/ruleset/testing.html - Wazuh 官方文档 · Detect an SSH brute-force attack(5710/5712 规则语义与 8 次/120 秒频率条件):https://documentation.wazuh.com/4.2/learning-wazuh/ssh-brute-force.html
- Wazuh Blog · Ransomware protection on Windows with Wazuh(Active Response 与 MITRE 映射示例):https://wazuh.com/blog/ransomware-protection-on-windows-with-wazuh/
合规提示:本文所述部署与规则验证流程仅限授权环境与防御研究用途,请在获得书面授权的资产范围内开展,并遵守所在地法律法规。