飞牛 fnOS NAS 接入 Zabbix 完整方案

飞牛 fnOS 底层是Debian 12 Linux，有 3 种接入方式，按推荐优先级排序：

1. Docker 容器运行 zabbix-agent（最稳、不污染系统，推荐家用 / 数据重要场景）
2. SSH 原生安装 zabbix-agent（指标最全，适合企业）
3. SNMP 被动监控（极简，仅基础硬件指标，无磁盘池 / 共享详情）

前置准备

1. 确认信息
   • Zabbix 服务端 IP：192.168.1.100（替换成你自己）
   • Zabbix 被动端口：10050；主动上报端口 10051
   • 飞牛 NAS 内网 IP：192.168.1.200
2. 飞牛后台开启权限
   • 系统设置 → 安全 → 开启SSH 登录，设置管理员密码
   • 功能中心 → 打开Docker（容器方案必备）
3. 防火墙放行：飞牛防火墙放行 10050 端口；Zabbix 服务器放行 NAS 入站 10050

方案一：Docker 部署 zabbix-agent（推荐）

1. SSH 登录飞牛 NAS

ssh admin@飞牛IP
sudo -i  # 提权root

2. 创建 agent 配置目录

mkdir -p /mnt/data/zabbix-agent
cd /mnt/data/zabbix-agent

3. 编写 zabbix_agentd.conf 配置文件

新建zabbix_agentd.conf，填入以下内容：

PidFile=/var/run/zabbix/zabbix_agentd.pid
LogFile=/var/log/zabbix/zabbix_agentd.log
LogFileSize=0
# Zabbix服务端IP
Server=192.168.1.100
# 主动上报地址（被动+主动双模式）
ServerActive=192.168.1.100
# NAS主机名（Zabbix后台创建主机要一致）
Hostname=fnOS-NAS01
ListenPort=10050
# 允许远程执行命令（可选，监控磁盘/进程需要）
EnableRemoteCommands=1
LogRemoteCommands=1
# 读取宿主机硬件、磁盘、挂载信息
AllowRoot=1

4. Docker Compose 一键启动

新建docker-compose.yml

version: "3"
services:
  zabbix-agent:
    image: zabbix/zabbix-agent:latest
    container_name: fn-zabbix-agent
    privileged: true
    network_mode: host
    volumes:
      - ./zabbix_agentd.conf:/etc/zabbix/zabbix_agentd.conf:ro
      - /:/hostfs:ro
      - /var/run:/var/run:ro
    environment:
      - ZBX_HOSTNAME=fnOS-NAS01
    restart: always

5. 启动容器

docker-compose up -d
# 查看日志验证连通
docker logs fn-zabbix-agent

方案二：原生 SSH 安装 zabbix-agent（指标最全）

fnOS 基于 Debian，直接用 apt 安装

1. SSH root 登录

sudo -i
apt update && apt install zabbix-agent -y

2. 修改配置文件

nano /etc/zabbix/zabbix_agentd.conf
# 修改这3行
Server=你的ZabbixIP
ServerActive=你的ZabbixIP
Hostname=fnOS-NAS01
# 开启远程命令
EnableRemoteCommands=1

3. 放行端口 + 自启

# Debian防火墙放行
ufw allow 10050/tcp
systemctl enable --now zabbix-agent
systemctl status zabbix-agent

方案三：SNMP 极简接入（无需 SSH/Docker）

适合不想开 SSH、只看 CPU / 内存 / 磁盘基础使用率

1. 飞牛 fnOS 安装 net-snmp 功能中心 → 应用商店搜索 SNMP 安装，后台开启服务
2. 配置 SNMP v2c（简单） 社区名：fnpublic，仅允许 Zabbix 服务器 IP 访问
3. Zabbix 后台添加主机，接口选择SNMP，端口 161，社区 fnpublic，链接模板Template OS Linux SNMP 缺点：无法监控 fnOS 专属存储池、Btrfs、SMB 共享、影视服务状态

Zabbix Web 后台配置（通用步骤）

1. 配置 → 主机群组 → 新建群组：fnOS NAS
2. 配置 → 主机 → 创建主机
   • 主机名称：和 agent 配置里Hostname完全一致（fnOS-NAS01）
   • 可见名称：飞牛主 NAS
   • 主机群组：选择 fnOS NAS
   • 接口：
     • Agent 代理：填入 NAS 内网 IP，端口 10050
3. 链接监控模板
   • 基础：Template OS Linux by Zabbix agent（CPU / 内存 / 磁盘 / 网络）
   • 进阶自定义：新增 fnOS 专属监控项（下方附自定义参数）
4. 验证连通：主机页面 → 检测可用性，显示绿色 OK 即成功

fnOS 专属自定义监控项（Docker / 原生 agent 通用）

在 agent 配置文件夹新建fn_custom.conf，在主配置添加Include=/etc/zabbix/zabbix_agentd.d/fn_custom.conf

# 1. fnOS存储池总使用率
UserParameter=fn.pool.used,df -h |grep /mnt/pool |awk '{print $5}' |sed 's/%//'
# 2. 系统总磁盘温度（取第一块硬盘）
UserParameter=fn.disk.temp,hddtemp /dev/sda |awk '{print $3}' |sed 's/°C//'
# 3. SMB在线连接数
UserParameter=fn.smb.conn,smbstatus |grep '^[0-9]' |wc -l
# 4. Docker容器运行数量
UserParameter=fn.docker.running,docker ps --quiet |wc -l
# 5. fnOS系统运行时间
UserParameter=fn.uptime,cat /proc/uptime |awk '{print int($1/86400)}'

修改配置后重启 agent 容器 / 服务，Zabbix 添加对应监控项即可采集 NAS 专属指标。

常见排错

1. Zabbix 提示无法连接 10050
   • 飞牛防火墙放行 10050；确认 Zabbix Server 能 ping 通 NAS
   • agent 配置Server填写正确服务器 IP，不要写 [0.0.0.0](0.0.0.0)
2. 磁盘数据采集为空
   • Docker 必须加privileged: true、挂载/:/hostfs
   • 原生 agent 开启AllowRoot=1
3. 主机名称不匹配报错 agent 内 Hostname 必须和 Zabbix 后台主机名一字不差，区分大小写
4. SNMP 无数据 检查飞牛 SNMP 白名单是否添加 Zabbix 服务器 IP，社区名一致