monitoringartist/zabbix-xxl

Zabbix XXL镜像说明

镜像概述

Zabbix XXL是针对Docker环境优化的标准Zabbix监控系统镜像，包含Zabbix服务器、Web界面、代理、Java网关、snmpd等核心组件，并集成了XXL社区扩展。镜像自动化处理Zabbix数据库导入等常规任务，便于快速部署。

核心功能

1. 完整组件支持：包含Zabbix服务器、代理、Web UI、Java网关、snmpd，支持MySQL/MariaDB数据库。
2. XXL扩展：集成Searcher（搜索工具）、Grapher（图表工具）、Zapix（API扩展）、模板自动导入、API命令执行等功能。
3. 灵活配置：通过环境变量（如ZS_前缀对应服务器配置）或卷挂载自定义配置文件。
4. 角色控制：可通过环境变量启用/禁用特定组件（如Zabbix代理、Java网关）。
5. 自动化部署：自动完成数据库初始化，支持Docker Compose快速启动。

使用场景

• 企业级基础设施监控（服务器、网络设备）。
• Docker容器环境监控（需配合Zabbix Agent XXL）。
• 分布式系统监控（通过Zabbix代理扩展）。
• 与Grafana集成实现可视化监控（需Grafana XXL镜像）。

配置说明

环境变量

• XXL功能变量：如XXL_searcher=true启用搜索工具，XXL_zapix=false禁用Zapix扩展。
• Zabbix组件变量：ZS_前缀对应服务器配置（如ZS_StartPollers=10），ZP_前缀对应代理配置。
• 角色变量：ZS_enabled=true启用服务器，ZP_enabled=false禁用代理。

卷挂载配置

通过-v /host/custom-config/:/etc/custom-config/挂载自定义配置文件（如zabbix_server.conf、php-zabbix.ini）。

部署示例

Docker命令部署

1. 创建数据库存储卷：

bash
docker run -d -v /var/lib/mysql --name zabbix-db-storage docker.xuanyuan.run/busybox:latest

2. 启动MariaDB数据库：

bash
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" \
    docker.xuanyuan.run/monitoringartist/zabbix-db-mariadb

3. 启动Zabbix XXL：

bash
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" \
    docker.xuanyuan.run/monitoringartist/zabbix-xxl:latest

等待约60秒初始化后，通过http://<Docker主机IP>访问Web界面（默认账号：Admin/zabbix）。

Docker Compose部署

bash
docker-compose up -d

管理任务

数据库备份

bash
# 配置数据备份
docker exec -ti zabbix-db /zabbix-backup/zabbix-mariadb-dump -u zabbix -p my_password -o /backups

# 全量备份
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"

数据库恢复

bash
docker rm -f zabbix
docker exec -i zabbix-db sh -c 'bunzip2 -dc /backups/<备份文件名>.sql.bz2 | mysql -uzabbix -pmy_password zabbix'
# 重新启动Zabbix容器

故障排除

• 查看容器状态：docker ps
• 查看Zabbix日志：docker logs zabbix
• 进入容器调试：docker exec -ti zabbix /bin/bash

版本选择

指定Zabbix版本（如3.0.0）：

bash
docker run ... monitoringartist/zabbix-xxl:3.0.0