Windows 10 客户端接入 Zabbix 完整教程

一、环境说明

• 服务端：已部署 Zabbix Server（Linux，记 IP：192.168.1.100 示例）
• 客户端：Windows 10 专业版 / 企业版
• 两种模式：Agent2（推荐，新版 Zabbix） / Agent1（旧版兼容） 下文统一使用 Zabbix Agent 2

二、Windows 安装 Zabbix Agent2

1. 下载对应安装包

打开官网下载页：https://www.zabbix.com/download_agents 选择：

• OS：Windows
• Agent：Zabbix Agent 2
• 匹配你的 Zabbix Server 版本（服务端 5.4 就下 5.4，6.0 下 6.0，大版本必须一致） 下载 .msi 安装包（64 位系统选 x64）

2. 静默 / 图形化安装

方式 1：图形界面安装（新手推荐）

1. 右键 MSI → 以管理员身份运行
2. 安装向导关键参数：
   • Hostname：Windows 主机名（后续 Zabbix 后台要一致）
   • Zabbix server IP：你的 Zabbix 服务端 IP
   • Agent listen port：默认10050
   • 安装路径默认即可，勾选安装为系统服务
3. 下一步完成安装

方式 2：CMD 管理员静默安装（批量自动化）

msiexec /i zabbix-agent2-6.0.30-windows-amd64.msi /qn ^
SERVER=192.168.1.100 ^
HOSTNAME=Win10-PC ^
INSTALLFOLDER="C:\zabbix-agent2"

3. 修改配置文件（核心）

路径：C:\zabbix-agent2\conf\zabbix_agent2.conf 用记事本 / VS Code 管理员打开，修改以下项：

# Zabbix服务端地址，逗号分隔多server
Server=192.168.1.100
# 主动模式上报地址（必须和Server一致）
ServerActive=192.168.1.100
# 本机唯一名称，后台添加主机时完全一致
Hostname=Win10-PC
# 允许日志、监控项扩展
LogFile=C:\zabbix-agent2\zabbix_agent2.log
LogFileSize=100

区分两种采集模式：

1. 被动模式（默认）：Server 主动连客户端 10050 端口
2. 主动模式：客户端主动上报数据，防火墙限制严格时用

三、Windows 防火墙放行端口

1. 被动模式放行 10050（Agent 监听）

管理员 CMD 执行：

netsh advfirewall firewall add rule name="Zabbix Agent2 10050" dir=in action=allow protocol=TCP localport=10050 remoteip=192.168.1.100 profile=any enable=yes

2. 若用主动模式，无需入站规则，只需出站放行

四、启动 / 重启 Zabbix Agent2 服务

管理员 CMD：

# 查看服务名
sc query | findstr zabbix
# 启动服务
net start zabbix_agent2
# 停止
net stop zabbix_agent2
# 设置开机自启（默认已开启）
sc config zabbix_agent2 start=auto

查看日志：C:\zabbix-agent2\zabbix_agent2.log，无报错即正常。

五、Zabbix Web 后台添加 Windows 主机

1. 登录 Zabbix 前端 → 配置 → 主机 → 创建主机
2. 主机参数：
   • 主机名称：和 agent 配置里 Hostname 完全相同（大小写敏感）
   • 可见名称：自定义展示名
   • 群组：选 Windows 主机组（没有就新建）
   • 接口 → Agent：填写 Windows10 本机 IP，端口 10050
3. 模板链接： 搜索 Windows by Zabbix agent 2 绑定模板（自带 CPU、内存、磁盘、网卡监控）
4. 保存

六、连通性排错（最常见问题）

1. 服务端测试能否连通客户端 10050

在 Zabbix Linux 服务器执行：

telnet 192.168.1.20 10050
# 或
nc -zv 192.168.1.20 10050

不通 = Windows 防火墙拦截 /agent 未启动 / IP 写错

2. Windows 本地自测 agent 是否正常

管理员 CMD 进入 agent 目录：

cd C:\zabbix-agent2\bin
# 测试获取系统信息
zabbix_agent2.exe -t system.hostname
# 测试和服务端通信
zabbix_agent2.exe -p 192.168.1.100

3. 常见报错原因

1. Hostname 前后不一致 → 监控项报no active checks on host
2. 防火墙未放 10050 → 主机不可达
3. Agent 服务未开机自启 → 重启电脑后失联
4. 服务端与客户端 Zabbix 版本相差过大 → 数据无法采集

七、可选优化（Windows 专用）

1. 监控磁盘 IO、文件、进程：模板自带无需额外配置
2. 监控 Windows 服务：添加自定义监控项监控特定软件服务
3. 监控事件日志：配置文件开启 WinEvent 日志采集
4. 主动模式配置 修改 conf：

Server=0.0.0.0/0
ServerActive=192.168.1.100:10051
Hostname=Win10-PC

1. 后台主机接口可不用填 IP，仅依赖主动上报

八、极简快速部署脚本（管理员 CMD 一键执行）

替换里面的服务端 IP、主机名再运行：

@echo off
set "ZABBIX_SERVER=192.168.1.100"
set "HOST_NAME=Win10-Local"
set "AGENT_PATH=C:\zabbix-agent2"
:: 放行防火墙
netsh advfirewall firewall add rule name="Zabbix Agent2 10050" dir=in action=allow protocol=TCP localport=10050 remoteip=%ZABBIX_SERVER% profile=any enable=yes >nul
echo 防火墙规则创建完成
:: 重启服务
net stop zabbix_agent2 >nul 2>&1
net start zabbix_agent2
echo Agent服务已重启，请去Zabbix后台添加主机
pause