Zabbix-Agent 主动模式自动注册
2024/1/4...大约 2 分钟
Zabbix-Agent 主动模式自动注册
主动模式下，Zabbix Agent 会自己连到 Server（默认 10051 端口）上报数据。所谓自动注册，就是 Agent 第一次连上来的时候，Server 根据你事先配好的「动作」自动把主机建好、扔进主机组、挂上模板，不用再去界面上一个个添加。
Agent 会按周期向 ServerActive 里填的地址发起连接，把自己的 Hostname 和监控数据送过去。Server 发现这是个没见过的 Hostname，就会触发自动注册，执行你设好的添加主机、关联模板等操作。所以适合那种机器多、装完 Agent 就想自动进监控、而且能统一规划 Hostname 或元数据的场景。
Agent 端配置
| 参数 | 说明 |
|---|---|
Server | 允许哪些 Server/Proxy 对本机做被动检查，可填 IP 或网段（如 192.168.1.0/24） |
ServerActive | Agent 主动上报的目标，填 Zabbix Server 或 Proxy 的 IP/域名 |
Hostname | 在 Zabbix 中显示的主机名，自动注册时用此值创建主机，需与 Server 动作条件一致 |
步骤：
- 编辑
/etc/zabbix/zabbix_agentd.conf或/etc/zabbix/zabbix_agent2.conf，按上表填写三项。 - 保存后执行
systemctl restart zabbix-agent2（或zabbix-agent）。
# 示例
Server=192.168.1.100
ServerActive=192.168.1.100
Hostname=web-server-01Server 端：自动注册动作
步骤：
- 进入 数据收集 → 自动注册 → 动作，新建动作。
- 名称：如「自动注册 - Linux 主机」。
- 条件：按主机名或主机元数据过滤（例如主机名匹配
*，或元数据包含os=linux）。 - 操作：在「操作」中依次添加：
| 操作类型 | 说明 |
|---|---|
| 添加主机 | 将新上报的 Hostname 添加为主机 |
| 添加到主机组 | 如 Linux servers、Auto registered |
| 与模板关联 | 如 Linux by Zabbix agent、Linux by Zabbix agent active |
| 设置主机接口 | 主动模式一般选「自动」即可 |
- 保存。当 Agent 以该 Hostname 首次连接时，主机会自动创建并挂好组和模板。
验证
| 步骤 | 操作 |
|---|---|
| 1 | 监控 → 主机：确认出现新主机，名称与 Agent 的 Hostname 一致 |
| 2 | 检查该主机已加入预期主机组并关联模板 |
| 3 | 监控 → 最新数据：选择该主机，确认有数据更新 |
和被动模式的区别在于：主动是 Agent 连 Server，用自动注册；被动是 Server 连 Agent，没有自动注册，要批量加主机得用自动发现，具体可以看 Zabbix-Agent 被动模式自动注册。
更新日志
2026/3/16 09:18
查看所有更新日志
21827-于0df28-于