Zabbix7.4 监控威联通 QNAP NAS 完整实操

在线答疑：乐维社区

前言

尝试使用 SNMP 对接 Zabbix 7.4 监控威联通 NAS 时，会遇到一个棘手问题：系统自带 Linux SNMP 模板大量监控项识别异常，网上也没有成熟可用的威联通专用 SNMP 模板。

为了拿到 CPU、内存、负载、存储空间等完整监控数据，本文采用在 QNAP 内通过 Container Station 运行zabbix‑agent2，使用主动模式完成 NAS 监控，实测各项指标采集正常。

环境信息

Zabbix 版本：7.4

威联通 QNAP NAS

模式：Zabbix Agent2 主动模式（Agent 主动上报数据，主机无需配置监听接口）

步骤 1：Zabbix 后台创建 QNAP 专属监控模板

复制克隆系统自带模板 Linux by Zabbix agent active，新模板命名为 Linux by Zabbix agent active_qnap。

修改模板内 2 个宏，用来过滤 NAS 系统分区，只监控业务共享存储目录：

{$VFS.FS.FSNAME.MATCHES}

原值：.+
修改值：^/hostfs/share/.*
作用：仅匹配share下用户实际共享数据目录，过滤 mnt 下各类系统分区。

{$VFS.FS.FSNAME.NOT_MATCHES}

原值：^(/dev|/sys|/run|/proc|.+/shm$)
修改值：^(/dev|/sys|/run|/proc|.+/shm$|/hostfs/mnt/ext.*)
作用：额外过滤威联通内置闪存小分区，避免发现大量无用系统挂载点。

💡操作截图参考：在模板 - 宏页面修改上述两个正则参数。

 

 

步骤 2：开启 NAS SSH 登录

由于 Docker 容器需要读取 NAS 底层系统路径，Container Station 图形界面无法完成复杂挂载配置，必须开启 SSH，使用命令行部署容器。

⚠️安全提醒：调试完成之后，记得关闭 SSH 服务，降低安全风险。

步骤 3：Container Station 配置镜像仓库，下载 zabbix‑agent2 镜像

威联通默认镜像仓库访问速度较差，建议新增国内镜像加速仓库。

打开【Container Station】→【存储库】→【添加存储库】

提供商选择：其他

仓库名称自定义，URL 填写加速地址：https://docker.1ms.run

填写账号密钥，测试连接通过后保存。

也可以使用其他可用 Docker 加速源。配置完成后，就可以拉取 zabbix/zabbix‑agent2:latest 镜像。

步骤 4：SSH 命令行部署 zabbix‑agent2 容器（主动模式）

SSH 登录 NAS，如果普通用户提示command not found，执行 sudo -i，输入密码切换 root 权限。

将下面脚本复制粘贴执行，务必修改 Zabbix 服务器 IP、NAS 主机名为你自己环境参数。

docker run -d \

--name zabbix-agent2-1 \

--network host \

--restart always \

-e ZBX_SERVER_HOST=192.168.168.3 \

-e ZBX_HOSTNAME=192.168.168.235 \

-e ZBX_STARTAGENTS=0 \

-e ZBX_TIMEOUT=15 \

-e ZBX_REFRESHACTIVECHECKS=60 \

-v /proc:/host/proc:ro \

-v /sys:/host/sys:ro \

-v /:/hostfs:ro \

docker.1ms.run/zabbix/zabbix-agent2:latest

参数简单说明

ZBX_SERVER_HOST：填写你的 Zabbix 服务端 IP 地址

ZBX_HOSTNAME：NAS 主机标识（Zabbix 主机页面主机名要和这个保持一致）

ZBX_STARTAGENTS=0：关闭被动模式，纯主动上报

--network host：使用宿主机网络

挂载 /proc /sys / 到容器内部/hostfs，让 agent 读取 NAS 真实系统信息

验证挂载是否生效

docker exec -it zabbix-agent2-1 ls /hostfs

可以看到 NAS 根目录文件列表，代表系统路径挂载成功。

查看 agent 日志确认连接状态：

docker logs zabbix-agent2-1

日志出现连接 Zabbix 服务端、active checks 相关输出，代表 agent 运行正常。

步骤 5：Zabbix Web 页面添加 NAS 主机

创建主机，主机名称必须和环境变量ZBX_HOSTNAME保持一致

模板链接选择第一步创建好的：Linux by Zabbix agent active_qnap

✅主动模式不需要配置主机接口！

保存，等待几分钟，即可采集 CPU、内存、负载、文件系统磁盘使用率等监控图表。

步骤 6：收尾安全操作

部署验证完成后，关闭威联通 NAS 的 SSH 服务，避免暴露 SSH 端口带来安全隐患。

效果预览

可以正常采集：系统负载、CPU 使用率、内存、Swap、各个共享卷存储空间使用率等数据，磁盘发现只会展示真实业务共享目录，不会刷出一堆系统闪存分区。

常见坑点总结

普通 NAS 用户执行 docker 命令报错：需要sudo -i切换 root；

Agent 一直无法上报：确认 NAS 网络可以访问 Zabbix 服务端，防火墙放行；确认主机名配置一致；

发现大量无用分区：检查模板宏的正则表达式是否复制完整；

镜像拉取失败：检查加速仓库连通性，更换其他 Docker 镜像源。