maksim77/zabbix

Zabbix 2.4 Docker镜像文档

镜像概述

Zabbix 2.4 Docker镜像是Zabbix社区提供的Docker化部署方案，基于CentOS 7构建，集成了Supervisor、Nginx和PHP环境，包含Zabbix Server、Web UI及几乎所有核心功能（MySQL支持、Java、SNMP、Curl、IPMI、IPv6、Jabber、fping等）。【重要提示】Zabbix 2.4已不再受支持，官方建议使用3.0版本（详见Zabbix生命周期政策）。

该镜像需配合外部MySQL/MariaDB数据库使用（可通过Docker容器部署）。

核心功能与特性

• 完整功能集成：编译了Zabbix几乎所有特性，包括MySQL支持、Java网关、SNMP监控、Curl、IPMI、IPv6、Jabber通知、fping等
• 环境组件：基于CentOS 7，集成Supervisor（进程管理）、Nginx（Web服务器）、PHP（Web UI运行环境）
• 灵活配置：支持通过环境变量或配置文件自定义Zabbix Server和Web UI参数
• 组件分离：可通过角色环境变量控制Zabbix Server、Agent、Web UI等组件的启用状态

使用场景

适用于需要快速部署Zabbix 2.4监控系统的环境（尽管已不推荐，仅作历史版本参考），支持单机部署或基于Docker Compose的编排部署。

使用方法

标准Docker部署流程

1. 创建数据持久化卷

bash
# 创建/var/lib/mysql作为MySQL数据持久化存储
docker run -d -v /var/lib/mysql --name zabbix-db-storage busybox:latest

2. 启动数据库容器

bash
# 启动MariaDB容器，默认使用1GB innodb_buffer_pool_size
docker run \
    -d \
    --name zabbix-db \
    -v /backups:/backups \
    -v /etc/localtime:/etc/localtime:ro \
    --volumes-from zabbix-db-storage \
    --env="MARIADB_USER=zabbix" \
    --env="MARIADB_PASS=my_password" \
    zabbix/zabbix-db-mariadb

3. 启动Zabbix容器

bash
# 启动Zabbix容器并链接到数据库
docker run \
    -d \
    --name zabbix \
    -p 80:80 \
    -p 10051:10051 \
    -v /etc/localtime:/etc/localtime:ro \
    --link zabbix-db:zabbix.db \
    --env="ZS_DBHost=zabbix.db" \
    --env="ZS_DBUser=zabbix" \
    --env="ZS_DBPassword=my_password" \
    zabbix/zabbix-2.4

# 等待约60秒初始化完成
# Zabbix Web UI将在80端口可用，Zabbix Server在10051端口监听

4. 数据备份

仅备份Zabbix配置数据：

bash
docker exec \
    -ti zabbix-db \
    /zabbix-backup/zabbix-mariadb-dump -u zabbix -p my_password -o /backups

完整数据库备份：

bash
docker exec \
    -ti zabbix-db \
    bash -c "\
    mysqldump -u zabbix -pmy_password zabbix | \
    bzip2 -cq9 > /backups/zabbix_db_dump_$(date +%Y-%m-%d-%H.%M.%S).sql.bz2"

Docker Compose部署

直接使用Docker Compose启动：

bash
docker-compose up -d

数据库容器说明

需先启动数据库容器以提供Zabbix所需的数据库服务，推荐使用zabbix/zabbix-db-mariadb镜像。

数据库容器启动示例：

bash
docker run \
    -d \
    --name zabbix-db \
    -p 3306:3306 \
    -v /etc/localtime:/etc/localtime:ro \
    --env="MARIADB_USER=zabbix" \
    --env="MARIADB_PASS=my_password" \
    zabbix/zabbix-db-mariadb

启动Zabbix容器时需使用与数据库容器相同的认证凭据。

配置说明

环境变量

可通过环境变量配置Zabbix Server和Web UI（PHP）参数，常用变量如下（完整列表见下方表格）：

完整环境变量列表：

配置文件挂载

可通过挂载卷的方式使用自定义配置文件（会覆盖环境变量配置），需挂载/etc/custom-config/目录：

bash
-v /host/custom-config/:/etc/custom-config/

支持的配置文件：

角色环境变量

通过以下变量控制Zabbix组件的启用状态：

默认启用所有Zabbix组件（除SNMP陷阱），可通过设置这些变量实现组件分离部署（如仅部署Web UI容器以实现扩展）。

访问Web界面

初始化完成后，通过http://docker_host_ip访问Zabbix Web UI，初始登录凭据：

• 用户名：Admin
• 密码：zabbix

故障排除

查看运行容器

bash
docker ps

查看Zabbix容器日志

bash
docker logs zabbix

进入容器内部

bash
docker exec -ti zabbix /bin/bash

查看镜像历史和层大小

bash
docker history --no-trunc=true zabbix/zabbix-2.4 | tr -s ' ' | tail -n+2 | awk -F " ago " '{print $2}'

运行特定版本

指定标签即可运行特定Zabbix 2.4版本（如2.4.4）：

bash
docker run \
    -d \
    --name zabbix \
    -p 80:80 \
    -p ***:*** \
    -v /etc/localtime:/etc/localtime:ro \
    --link zabbix-db:zabbix.db \
    --env="ZS_DBHost=zabbix.db" \
    --env="ZS_DBUser=zabbix" \
    --env="ZS_DBPassword=my_password" \
    zabbix/zabbix-2.4:2.4.4