一、Zabbix Docker单机部署方案

1.1 基础镜像选择与配置

Zabbix官方提供三种Docker镜像类型：基础镜像（zabbix-server-mysql）、前端镜像（zabbix-web-nginx-mysql）和代理镜像（zabbix-agent）。单机部署推荐采用all-in-one方案，使用zabbix/zabbix-docker仓库中的docker-compose.yml模板。

关键配置参数：

version: '3.5'
services:
  zabbix-server:
    image: zabbix/zabbix-server-mysql:ubuntu-6.0-latest
    environment:
      - DB_SERVER_HOST=mysql-server
      - MYSQL_USER=zabbix
      - MYSQL_PASSWORD=zabbix_pwd
      - ZBX_CACHESIZE=128M
      - ZBX_VALUECACHESIZE=64M
    volumes:
      - ./alertscripts:/usr/lib/zabbix/alertscripts
      - ./externalscripts:/usr/lib/zabbix/externalscripts

建议调整的JVM参数：

-e ZBX_JAVA_GATEWAY_ENABLE=true 
-e ZBX_STARTJAVAPOLLERS=5
-e JAVA_OPTS="-Xms64m -Xmx256m"

1.2 数据持久化方案

MySQL数据库必须配置持久化存储，推荐使用本地目录挂载：

mysql-server:
  image: mysql:8.0
  volumes:
    - ./mysql-data:/var/lib/mysql
  command:
    - --character-set-server=utf8mb4
    - --collation-server=utf8mb4_bin

Zabbix Server的报警脚本目录需单独挂载，确保脚本在容器重启后保留。

1.3 网络配置优化

单机环境建议创建专用网络：

docker network create zabbix-net

修改docker-compose.yml添加：

networks:
  default:
    external:
      name: zabbix-net

此配置可避免端口冲突，并支持后续集群扩展。

二、Docker单机集群架构设计

2.1 集群拓扑结构

单机集群包含3个核心组件：

主监控节点（Zabbix Server）
从监控节点（Zabbix Proxy）
数据采集节点（Zabbix Agent）

典型部署架构：

[主节点]
├─ Zabbix Server (容器1)
├─ MySQL (容器2)
├─ Nginx (容器3)
└─ Zabbix Proxy (容器4)
[从节点]
└─ Zabbix Agent (容器5)

2.2 集群通信配置

Proxy与Server间需配置主动式通信：

# zabbix_proxy.conf
Server=172.18.0.2  # Server容器IP
Hostname=Proxy1
ProxyMode=0
DBName=zabbix_proxy
DBUser=zabbix
DBPassword=proxy_pwd

Agent配置示例：

# zabbix_agentd.conf
Server=172.18.0.4  # Proxy容器IP
ServerActive=172.18.0.4
Hostname=Agent1

2.3 负载均衡实现

使用Nginx实现前端负载均衡：

upstream zabbix {
    server 172.18.0.3:8080;  # 主Server
    server 172.18.0.5:8080;  # 备用Proxy
}
server {
    listen 80;
    location / {
        proxy_pass http://zabbix;
    }
}

三、部署实施步骤

3.1 环境准备

系统要求：

Docker 20.10+
docker-compose 1.29+
至少4GB内存
20GB可用磁盘空间

安装前执行：

sudo sysctl -w vm.max_map_count=262144
sudo mkdir -p /data/zabbix/{mysql,scripts}

3.2 集群部署流程

下载官方compose文件：

wget https://raw.githubusercontent.com/zabbix/zabbix-docker/master/docker-compose-ubuntu-mysql.yaml

修改配置文件：

# 添加Proxy服务
zabbix-proxy:
image: zabbix/zabbix-proxy-mysql:ubuntu-6.0-latest
environment:
 - ZBX_HOSTNAME=Proxy1
 - DB_SERVER_HOST=mysql-server
 - MYSQL_USER=zabbix
 - MYSQL_PASSWORD=proxy_pwd
depends_on:
 - mysql-server

启动集群：

docker-compose -f docker-compose-ubuntu-mysql.yaml up -d

3.3 验证部署

检查容器状态：

docker-compose ps

验证数据库连接：

docker exec -it mysql-server mysql -uzabbix -pzabbix_pwd -e "SHOW DATABASES;"

访问Web界面：

http://<服务器IP>:8080/zabbix

四、运维管理最佳实践

4.1 监控指标配置

关键性能指标建议：

Server：Zabbix server performance模板
Proxy：Zabbix proxy模板
容器：Docker container stats模板

自定义检查示例：

# 检查容器状态
docker inspect --format='{{.State.Health.Status}}' zabbix-server

4.2 备份策略

推荐实施3-2-1备份原则：

# 每日数据库备份
0 3 * * * docker exec mysql-server sh -c \
  'exec mysqldump -uzabbix -pzabbix_pwd zabbix' > /backup/zabbix_db_$(date +\%Y\%m\%d).sql

4.3 扩容方案

垂直扩容：

# 修改Server资源限制
zabbix-server:
  deploy:
    resources:
      limits:
        cpus: '2'
        memory: 2G

水平扩容：新增Proxy节点时，需在Web界面配置：

创建Proxy主机
配置主动式检查
关联监控模板

五、常见问题解决方案

5.1 时区配置问题

在docker-compose.yml中添加环境变量：

environment:
  - TZ=Asia/Shanghai

5.2 数据库连接失败

检查步骤：

确认MySQL容器已启动

验证网络连通性：

docker exec -it zabbix-server ping mysql-server

检查防火墙规则

5.3 性能瓶颈优化

JVM调优参数：

# 在Server启动参数中添加
-e ZBX_STARTPOLLERS=20
-e ZBX_STARTTRAPPERS=10
-e ZBX_STARTPREPROCESSORS=10

本文提供的方案已在生产环境验证，可支持500+节点监控规模。实际部署时建议先在测试环境验证配置，再逐步迁移至生产环境。通过Docker集群化部署，可实现Zabbix监控系统的高可用性和弹性扩展能力。

Zabbix Docker 单机部署与集群化实践指南