zabbix-server-mysql-odbc 镜像文档

镜像概述

本镜像基于官方Zabbix Server构建，采用MySQL作为后端数据库存储，并预装ODBC驱动组件，支持与MSSQL（Microsoft SQL Server）和Oracle数据库建立连接。主要用于企业级监控系统部署，实现对包含MSSQL、Oracle在内的多类型数据库及相关IT基础设施的统一监控与管理。

核心功能与特性

• Zabbix Server核心能力：提供数据采集、处理、存储、告警触发等完整监控功能
• MySQL后端集成：默认使用MySQL数据库存储监控数据，兼容Zabbix官方数据库架构
• ODBC驱动支持：预装MSSQL ODBC Driver和Oracle ODBC Driver，无需额外安装即可配置数据库连接
• 标准化部署：遵循Docker容器化最佳实践，支持环境变量配置、数据卷挂载，易于集成到现有监控架构

使用场景与适用范围

• 需监控MSSQL或Oracle数据库性能指标（如连接数、查询延迟、表空间使用率）的企业环境
• 多数据库类型混合部署的IT基础设施监控（如同时存在MySQL、MSSQL、Oracle的业务系统）
• 基于Docker/Kubernetes的容器化监控平台搭建
• 需要通过ODBC协议采集数据库监控数据的Zabbix部署场景

使用方法与配置说明

基础部署（Docker Run）

docker run -d \
  --name zabbix-server-mysql-odbc \
  -p 10051:10051 \
  -e DB_HOST=mysql-server \
  -e DB_NAME=zabbix \
  -e DB_USER=zabbix \
  -e DB_PASSWORD=zabbix_password \
  -e ZBX_LOGLEVEL=3 \
  -v /host/odbc.ini:/etc/odbc.ini \
  -v /host/zabbix/alertscripts:/usr/lib/zabbix/alertscripts \
  --link mysql-server:mysql \
  zabbix-server-mysql-odbc:latest

环境变量配置

ODBC驱动配置

1. 配置文件路径：容器内ODBC配置文件路径为/etc/odbc.ini（系统DSN）和/root/.odbc.ini（用户DSN），建议通过数据卷挂载主机配置文件
2. MSSQL数据源配置示例（odbc.ini）：

   [MSSQL_Server]
   Driver=ODBC Driver 17 for SQL Server
   Server=192.168.1.100,1433
   Database=MonitoringDB
   UID=sa
   PWD=sql_password
   

3. Oracle数据源配置示例（odbc.ini）：

   [Oracle_DB]
   Driver=Oracle 19c ODBC driver
   Server=//192.168.1.200:1521/ORCLCDB
   User Id=system
   Password=oracle_password
   

Docker Compose部署示例

version: '3'
services:
  zabbix-server:
    image: zabbix-server-mysql-odbc:latest
    ports:
      - "10051:10051"
    environment:
      - DB_HOST=mysql
      - DB_NAME=zabbix
      - DB_USER=zabbix
      - DB_PASSWORD=zabbix_pwd
      - ZBX_LOGLEVEL=3
    volumes:
      - ./odbc.ini:/etc/odbc.ini
      - zabbix_alertscripts:/usr/lib/zabbix/alertscripts
    depends_on:
      - mysql
    restart: always

  mysql:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root_pwd
      - MYSQL_DATABASE=zabbix
      - MYSQL_USER=zabbix
      - MYSQL_PASSWORD=zabbix_pwd
    volumes:
      - mysql_data:/var/lib/mysql
    restart: always

volumes:
  mysql_data:
  zabbix_alertscripts:

注意事项

• 首次启动需确保MySQL数据库已初始化Zabbix Schema（可通过挂载Zabbix官方SQL脚本实现）
• ODBC驱动版本需与目标数据库版本兼容（MSSQL驱动建议2017+，Oracle驱动建议12c+）
• 容器运行用户需对挂载的ODBC配置文件有读取权限，建议权限设置为644
• 生产环境建议启用数据卷持久化存储，避免容器重启导致配置丢失