pthoelken/fritzbox-zabbix-monitoring

fritzbox-zabbix-monitoring 镜像文档

镜像概述

fritzbox-zabbix-monitoring 是一个专为AVM FritzBox路由器设计的Docker镜像，旨在通过Zabbix监控系统实现对FritzBox设备的全面监控。该镜像集成了数据采集脚本和Zabbix适配组件，能够自动收集FritzBox的系统状态、网络流量、连接信息等关键指标，并将数据发送至Zabbix Server，帮助用户实时掌握设备运行状态。

核心功能与特性

• 多指标采集：支持收集FritzBox设备的CPU使用率、内存占用、网络接口流量、连接数、温度、DSL/光纤线路状态等关键指标。
• 广泛兼容性：适配多种FritzBox型号（如Fritz!Box 7490、7590、6591等）及不同固件版本。
• Zabbix集成：通过Zabbix Sender协议将监控数据推送至Zabbix Server，支持Zabbix Agent模式或独立Sender模式。
• 配置灵活：通过环境变量或配置文件自定义监控参数、采集频率、认证信息等。
• 轻量设计：基于Alpine Linux构建，镜像体积小，资源占用低。

使用场景与适用范围

• 家庭网络监控：个人用户通过Zabbix监控家庭FritzBox路由器的网络状态和性能。
• 小型企业环境：企业IT管理员监控办公网络中的FritzBox设备，确保网络稳定运行。
• Zabbix生态集成：已部署Zabbix监控系统的环境中，快速扩展对FritzBox设备的监控能力。

使用方法与配置说明

环境要求

• 运行中的Zabbix Server（支持Zabbix 4.0及以上版本）。
• 可访问FritzBox设备的网络环境（需确保Docker容器与FritzBox之间网络互通）。
• FritzBox设备已启用API访问（通常在“系统”>“FRITZ!Box用户”中创建具有“FRITZ!Box设置”权限的用户）。

环境变量配置

Docker部署示例

1. 直接运行（docker run）

bash
docker run -d \
  --name fritzbox-monitor \
  --restart unless-stopped \
  -e FRITZBOX_IP=192.168.178.1 \
  -e FRITZBOX_USER=zabbix-monitor \
  -e FRITZBOX_PASSWORD=your-secure-password \
  -e ZABBIX_SERVER=zabbix-server.example.com \
  -e ZABBIX_HOST=fritzbox-office \
  -e COLLECTION_INTERVAL=60 \
  docker.xuanyuan.run/pthoelken/fritzbox-zabbix-monitoring:latest

2. Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  fritzbox-monitor:
    image: docker.xuanyuan.run/pthoelken/fritzbox-zabbix-monitoring:latest
    container_name: fritzbox-monitor
    restart: unless-stopped
    environment:
      - FRITZBOX_IP=192.168.178.1
      - FRITZBOX_USER=zabbix-monitor
      - FRITZBOX_PASSWORD=your-secure-password
      - ZABBIX_SERVER=192.168.1.100  # Zabbix Server IP
      - ZABBIX_HOST=fritzbox-home
      - COLLECTION_INTERVAL=30
    networks:
      - zabbix-network  # 确保与Zabbix Server在同一网络

networks:
  zabbix-network:
    external: true  # 假设已存在zabbix-network网络

启动容器：

bash
docker-compose up -d

Zabbix Server配置

1. 导入Zabbix模板

1. 从https://github.com/pthoelken/fritzbox-zabbix-monitoring%E4%B8%8B%E8%BD%BDZabbix%E6%A8%A1%E6%9D%BF%E6%96%87%E4%BB%B6%EF%BC%88%E9%80%9A%E5%B8%B8%E4%B8%BA%60template_fritzbox.xml%60%EF%BC%89%E3%80%82
2. 登录Zabbix Web界面，导航至 配置 > 模板 > 导入，上传模板文件。

2. 创建Zabbix主机

1. 导航至 配置 > 主机 > 创建主机。
2. 设置 主机名称（需与ZABBIX_HOST环境变量值一致）。
3. 关联已导入的FritzBox模板。
4. 配置主机接口（如无需Agent，可跳过；若使用Agent模式，需配置Zabbix Agent接口）。
5. 保存配置。

故障排查

• 认证失败：检查FRITZBOX_USER和FRITZBOX_PASSWORD是否正确，确保用户具有“FRITZ!Box设置”权限。
• 数据未上报：验证ZABBIX_SERVER地址和端口是否可达，检查容器日志（docker logs fritzbox-monitor）查看错误信息。
• 指标缺失：确认FritzBox型号是否支持对应指标，更新固件至最新版本。

参考链接

• https://github.com/pthoelken/fritzbox-zabbix-monitoring
• Zabbix官方文档
• https://en.avm.de/service/fritzbox/