自定义Zabbix代理(MySQL版)镜像文档

镜像概述

本镜像基于Zabbix proxy MySQL版本构建，是一个增强型网络监控代理镜像。在原生Zabbix代理功能基础上，预装了snmpwalk、netcat、nmap和fping等常用网络诊断与监控工具，旨在为复杂网络环境提供更全面的监控能力，简化监控脚本开发与部署流程。

核心功能与特性

基础功能

• 完整保留Zabbix proxy原生功能，支持MySQL数据库后端存储监控数据
• 与Zabbix Server无缝集成，实现分布式监控架构

预装工具集

• snmpwalk：用于SNMP协议设备的OID遍历与监控数据采集
• netcat：网络连接测试工具，支持TCP/UDP端口连通性检测
• nmap：网络扫描工具，可用于端口开放状态检测与服务识别
• fping：高效网络连通性检测工具，支持批量主机存活状态检查

使用场景

• 扩展监控能力：需要通过SNMP、端口扫描等方式监控网络设备的Zabbix环境
• 复杂网络监控：包含多种网络设备（交换机、路由器、IoT设备）的企业网络环境
• 自定义监控开发：需要基于系统工具编写自定义监控脚本的场景
• 网络故障诊断：在监控节点集成诊断工具，便于快速排查监控异常

使用方法

基本使用（Docker Run）

bash
docker run -d \
  --name zabbix-proxy-custom \
  -e ZBX_SERVER_HOST=zabbix-server.example.com \
  -e ZBX_SERVER_PORT=*** \
  -e DB_SERVER_HOST=mysql.example.com \
  -e DB_SERVER_PORT=3306 \
  -e DB_NAME=zabbix_proxy \
  -e DB_USER=zabbix \
  -e DB_PASSWORD=password \
  -p ***:*** \
  --restart unless-stopped \
  [镜像名称]

环境变量说明

配置文件挂载

如需使用自定义配置文件，可通过卷挂载方式替换默认配置：

bash
docker run -d \
  --name zabbix-proxy-custom \
  -v /host/path/zabbix_proxy.conf:/etc/zabbix/zabbix_proxy.conf \
  -e DB_SERVER_HOST=mysql.example.com \
  -e DB_USER=zabbix \
  -e DB_PASSWORD=password \
  [镜像名称]

Docker Compose示例

yaml
version: '3'

services:
  zabbix-proxy:
    image: [镜像名称]
    container_name: zabbix-proxy-custom
    restart: unless-stopped
    ports:
      - "***:***"
    environment:
      - ZBX_SERVER_HOST=zabbix-server
      - ZBX_SERVER_PORT=***
      - DB_SERVER_HOST=mysql
      - DB_SERVER_PORT=3306
      - DB_NAME=zabbix_proxy
      - DB_USER=zabbix
      - DB_PASSWORD=zabbix_password
      - ZBX_PROXYNAME=custom-proxy-01
    volumes:
      - ./zabbix_proxy.conf:/etc/zabbix/zabbix_proxy.conf
      - proxy-data:/var/lib/zabbix
    depends_on:
      - mysql

  mysql:
    image: mysql:8.0
    container_name: zabbix-proxy-mysql
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=zabbix_proxy
      - MYSQL_USER=zabbix
      - MYSQL_PASSWORD=zabbix_password
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  proxy-data:
  mysql-data:

注意事项

• 确保Zabbix Server已配置对应的代理名称（与ZBX_PROXYNAME一致）
• MySQL数据库需提前创建zabbix_proxy数据库并授权相应用户
• 预装工具可通过docker exec -it [容器名] [工具名]直接使用，如docker exec -it zabbix-proxy-custom snmpwalk -v2c -c public 192.168.1.1
• 生产环境建议挂载数据卷以持久化代理配置和运行数据