monitoringartist/zabbix-3.0-xxl

Zabbix XXL 镜像说明

镜像概述

Zabbix XXL是为Docker环境优化的标准Zabbix监控系统镜像，包含完整Zabbix组件（服务器、代理、Agent、Java网关、SNMPd）及XXL社区扩展。它自动化数据库初始化等常规任务，降低部署复杂度，适用于容器化环境下的基础设施监控。

核心功能

1. 全组件支持: 内置Zabbix服务器、代理、Agent、Java网关、SNMPd守护进程，兼容MySQL/MariaDB数据库。
2. XXL扩展特性: 提供Searcher（搜索工具）、Grapher（图表工具）、Zapix（API扩展）、模板自动导入、API命令执行等功能（部分需通过环境变量启用）。
3. 灵活配置方式:
   • 环境变量配置：通过ZS_（服务器）、ZP_（代理）前缀设置Zabbix参数，如ZS_StartPollers调整轮询器数量。
   • 卷挂载配置：通过/etc/custom-config/挂载自定义配置文件，覆盖默认设置。
   • 角色控制：通过变量（如ZS_enabled、ZW_enabled）启用/禁用特定组件。
4. 自动化部署: 自动完成数据库导入，支持Docker Compose快速启动。

使用场景

• 基础设施监控: 监控服务器、容器、网络设备的性能与状态。
• 可扩展部署: 通过Docker Compose或Kubernetes实现Zabbix集群化，满足高可用需求。
• 专用组件部署: 单独运行Web UI或代理容器，优化资源利用。

配置说明

环境变量

• XXL功能开关: XXL_searcher=true（启用搜索工具）、XXL_zapix=false（默认禁用Zapix）等。
• Zabbix服务器参数: ZS_DBHost（数据库地址）、ZS_DBPassword（数据库密码）等。
• 角色变量: ZS_enabled=true（启用服务器）、SNMPTRAP_enabled=false（禁用SNMP陷阱）等。

卷挂载配置

通过-v /host/custom-config/:/etc/custom-config/挂载自定义配置文件，支持覆盖PHP（php-zabbix.ini）、Zabbix服务器（zabbix_server.conf）、代理（zabbix_proxy.conf）等配置。

部署示例

Docker Run部署

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 UI，默认账号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
# 删除现有Zabbix容器
docker rm -f zabbix
# 从备份恢复（覆盖现有数据）
docker exec -i zabbix-db sh -c 'bunzip2 -dc /backups/zabbix_db_dump_2016-05-25-02.57.46.sql.bz2 | mysql -uzabbix -p --password=my_password zabbix'
# 重新启动Zabbix容器（参考部署命令）