epicmorg/zabbix-server-mysql

Zabbix Server MySQL 镜像文档!logo## 镜像概述和主要用途Zabbix是企业级开源分布式监控解决方案，可监控网络参数、服务器健康状态及完整性。Zabbix Server作为其核心组件，承担数据轮询与陷阱处理、触发器计算、通知发送等核心功能，是Zabbix Agent和Proxy报告系统可用性与完整性数据的中心节点，还能远程检查网络服务（如Web服务器、邮件服务器）。

本镜像为官方Zabbix Server Docker镜像，基于Alpine Linux v3.11、Ubuntu 18.04（bionic）和CentOS 7构建，使用MySQL数据库，提供多种版本标签，满足不同环境需求。## 核心功能和特性### 核心功能- 数据采集：支持主动轮询和被动陷阱数据收集

• 触发器计算：基于采集数据计算触发器状态
• 通知机制：灵活配置邮件等告警通知
• 远程服务检查：可直接检查网络服务可用性
• 数据库管理：自动检查数据库可用性，创建必要数据库和用户

特性- 多版本支持：涵盖Zabbix 3.0、4.0、5.0等多个版本（部分旧版本已标注不支持）

• 多基础镜像：提供Alpine、Ubuntu、CentOS三种基础镜像，满足不同环境需求
• 环境变量配置：通过环境变量灵活配置Zabbix Server参数
• 卷挂载支持：提供多个卷用于自定义脚本、模块、证书等

使用场景和适用范围适用于企业级网络监控、服务器健康监控、网络服务可用性监控等场景，尤其适合需要集中管理监控数据、快速响应系统问题及进行容量规划的组织。## 详细使用方法和配置说明### 启动Zabbix Server容器使用以下命令启动Zabbix Server容器：bashdocker run --name some-zabbix-server-mysql -e DB_SERVER_HOST="some-mysql-server" -e MYSQL_USER="some-user" -e MYSQL_PASSWORD="some-password" -d zabbix/zabbix-server-mysql:tag参数说明：- some-zabbix-server-mysql：容器名称

• some-mysql-server：MySQL服务器IP或DNS名称
• some-user：连接Zabbix数据库的用户
• some-password：连接MySQL服务器的密码
• tag：指定镜像版本标签（如alpine-5.0-latest、ubuntu-latest等）### 容器shell访问与日志查看#### 进入容器shellbashdocker exec -ti some-zabbix-server-mysql /bin/bash#### 查看Zabbix Server日志bashdocker logs some-zabbix-server-mysql### 环境变量配置启动容器时可通过环境变量调整Zabbix Server配置，主要变量如下：#### 数据库连接相关- DB_SERVER_HOST：MySQL服务器IP或DNS名称，默认值mysql-server
• DB_SERVER_PORT：MySQL服务器端口，默认值3306
• MYSQL_USER/MYSQL_USER_FILE：Zabbix数据库用户名（或存储用户名的文件路径），默认值zabbix
• MYSQL_PASSWORD/MYSQL_PASSWORD_FILE：Zabbix数据库密码（或存储密码的文件路径），默认值zabbix
• MYSQL_ROOT_PASSWORD/MYSQL_ROOT_PASSWORD_FILE：MySQL root用户密码（用于创建数据库和用户）
• MYSQL_DATABASE：Zabbix数据库名称，默认值zabbix#### 核心配置相关- ZBX_LOADMODULE：逗号分隔的可加载模块列表（需配合/var/lib/zabbix/modules卷）
• ZBX_DEBUGLEVEL：调试级别，默认值3（警告），可选值：0（基本信息）、1（严重信息）、2（错误信息）、3（警告）、4（调试）、5（扩展调试）
• ZBX_TIMEOUT：检查处理超时时间（秒），默认值4
• ZBX_JAVAGATEWAY_ENABLE：是否启用Java Gateway通信，默认值false#### 其他常用变量（完整列表见官方文档）ZBX_STARTPOLLERS=5 # 轮询进程数 ZBX_CACHESIZE=8M # 缓存大小 ZBX_HISTORYCACHESIZE=16M # 历史数据缓存大小 ZBX_TRENDCACHESIZE=4M # 趋势数据缓存大小 ZBX_LOGSLOWQUERIES=3000 # 慢查询日志阈值（毫秒）### 卷挂载配置容器支持以下卷挂载，用于扩展功能：- /usr/lib/zabbix/alertscripts：自定义告警脚本目录（对应AlertScriptsPath配置）
• /usr/lib/zabbix/externalscripts：外部检查脚本目录（对应ExternalScripts配置）
• /var/lib/zabbix/modules：加载额外模块目录（配合ZBX_LOADMODULE使用）
• /var/lib/zabbix/enc：TLS相关文件存储目录
• /var/lib/zabbix/ssh_keys：SSH检查和操作的密钥目录（对应SSHKeyLocation配置）
• /var/lib/zabbix/ssl/certs：SSL客户端证书目录（对应SSLCertLocation配置）
• /var/lib/zabbix/ssl/keys：SSL私钥目录（对应SSLKeyLocation配置）
• /var/lib/zabbix/ssl/ssl_ca：CA证书目录（对应SSLCALocation配置）
• /var/lib/zabbix/snmptraps：SNMP陷阱日志文件目录（需启用ZBX_ENABLE_SNMP_TRAPS=true）
• /var/lib/zabbix/mibs：MIB文件目录（不支持子目录）
• /var/lib/zabbix/export：事件、历史和趋势数据的JSON导出目录（需配置ZBX_EXPORTFILESIZE）## 镜像变体### zabbix-server-mysql:ubuntu-<version>默认镜像，基于Ubuntu 18.04，适合大多数场景，包含常用工具，兼容性好。### zabbix-server-mysql:alpine-<version>基于Alpine Linux，体积更小（约5MB基础镜像），适合对镜像大小有严格要求的场景。使用musl libc替代glibc，部分依赖glibc的软件可能存在兼容性问题。## 支持的Docker版本官方支持Docker 1.12.0及以上版本，旧版本（低至1.6）提供尽力支持。## 用户反馈### 文档官方文档存储在https://github.com/zabbix/zabbix-docker/%E7%9A%84%60server-mysql/%60%E7%9B%AE%E5%BD%95%E4%B8%8B%E3%80%82### 问题反馈如遇问题，可通过https://github.com/zabbix/zabbix-docker/issues%E6%8F%90%E4%BA%A4%E3%80%82### 贡献欢迎通过GitHub Pull Request贡献代码，建议先通过Issue讨论重大功能变更。