一、环境准备与基础架构设计

1.1 Docker单机环境配置规范

Docker单机环境需满足Zabbix运行的基础要求：CPU核心数≥2、内存≥4GB、磁盘空间≥50GB。推荐使用Ubuntu 22.04 LTS或CentOS 8作为宿主机系统，这两个版本对Docker和Zabbix的兼容性最佳。安装Docker CE时，需通过官方仓库安装以确保版本一致性，执行命令示例：

# Ubuntu 22.04安装示例
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker

1.2 Zabbix Docker镜像选择策略

Zabbix官方提供三种Docker镜像类型：基础版（zabbix/zabbix-server-mysql）、完整版（zabbix/zabbix-appliance）和定制版。对于单机部署，推荐使用zabbix/zabbix-server-mysql:alpine-6.0-latest镜像，该版本采用Alpine Linux基础，镜像体积仅300MB，启动速度比Ubuntu基础镜像快40%。

二、Zabbix Docker单机部署全流程

2.1 数据库容器配置要点

MySQL 8.0容器需进行特殊配置以支持Zabbix：

# docker-compose.yml示例片段
mysql:
  image: mysql:8.0
  command: --default-authentication-plugin=mysql_native_password
  environment:
    MYSQL_ROOT_PASSWORD: zabbix_root_pwd
    MYSQL_DATABASE: zabbix
    MYSQL_USER: zabbix
    MYSQL_PASSWORD: zabbix_pwd
  volumes:
    - ./mysql_data:/var/lib/mysql
  ulimits:
    nproc: 65535
    nofile:
      soft: 20000
      hard: 40000

关键配置项说明：

default-authentication-plugin必须设置为mysql_native_password，否则Zabbix 6.0+无法连接
文件描述符限制需提升至20000以上，防止高并发时连接数不足
持久化存储建议使用宿主机目录映射，避免容器重建导致数据丢失

2.2 Zabbix服务容器配置优化

Zabbix Server配置需关注以下参数：

# Dockerfile定制示例
FROM zabbix/zabbix-server-mysql:alpine-6.0-latest
RUN sed -i 's/# DBHost=localhost/DBHost=mysql/' /etc/zabbix/zabbix_server.conf
RUN sed -i 's/# StartPollers=5/StartPollers=20/' /etc/zabbix/zabbix_server.conf
RUN echo "HistoryCacheSize=128M" >> /etc/zabbix/zabbix_server.conf

关键优化点：

StartPollers建议设置为CPU核心数的2-3倍
HistoryCacheSize根据监控项数量调整，每1000个监控项约需8MB缓存
必须显式指定DBHost，即使使用docker-compose的links功能

2.3 前端容器部署与Nginx配置

Zabbix Web前端建议使用Nginx作为反向代理：

server {
    listen 80;
    server_name zabbix.example.com;
    location / {
        proxy_pass http://zabbix-web:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
    client_max_body_size 16M;
    keepalive_timeout 10;
}

配置要点：

必须设置X-Forwarded-For头以正确记录客户端IP
client_max_body_size需增大以支持大尺寸告警消息
建议启用HTTPS，可使用Let’s Encrypt免费证书

三、Docker单机集群监控方案

3.1 集群监控架构设计

单机环境下的Docker集群监控可采用分层架构：

宿主机层：通过Zabbix Agent监控系统资源
Docker引擎层：使用cAdvisor或Docker内置指标
容器层：通过Zabbix Docker模板监控关键指标

3.2 容器发现与自动注册

实现容器自动监控的关键配置：

# 在Zabbix Server容器内执行
zabbix_agentd -c /etc/zabbix/zabbix_agentd.conf \
  -i "UserParameter=docker.discovery[*],docker inspect --format='{{.Name}}' \$(docker ps -aq)"

配合Zabbix的LLD（低级别发现）功能，可自动发现并监控新启动的容器。

3.3 关键监控指标配置

四、高级配置与故障排查

4.1 性能调优技巧

Zabbix Server调优：
- 调整StartDBSyncers为4-8，取决于数据库性能
- 设置CacheSize为可用内存的30%-50%
- 启用ValueCacheSize缓存历史数据

数据库调优：

-- MySQL优化示例
SET GLOBAL innodb_buffer_pool_size=2G;
SET GLOBAL tmp_table_size=256M;
SET GLOBAL max_heap_table_size=256M;

4.2 常见故障解决方案

连接数据库失败：
- 检查DBHost配置是否正确
- 验证MySQL用户权限：
```
GRANT ALL PRIVILEGES ON zabbix.* TO 'zabbix'@'%';
FLUSH PRIVILEGES;
```
前端502错误：
- 检查Nginx与Zabbix Web容器的网络连通性
- 查看Zabbix Web日志：
```
docker logs zabbix-web 2>&1 | grep -i error
```
监控数据延迟：
- 增加StartPollers和StartPollersUnreachable值
- 检查数据库负载，必要时分表

五、最佳实践建议

备份策略：

每日自动备份Zabbix数据库

备份脚本示例：

#!/bin/bash
BACKUP_DIR="/backups/zabbix"
DATE=$(date +%Y%m%d)
docker exec mysql mysqldump -uzabbix -pzabbix_pwd zabbix > $BACKUP_DIR/zabbix_db_$DATE.sql

升级路径：
- 小版本升级（如6.0.1→6.0.2）：直接替换镜像并重启容器
- 大版本升级（如5.0→6.0）：需先导出数据，升级后导入
安全加固：
- 限制Zabbix API访问IP
- 定期轮换数据库密码
- 禁用不必要的Zabbix功能模块

通过以上配置，可在单机Docker环境中构建高可用的Zabbix监控系统，既能有效监控宿主机资源，又能全面掌握Docker容器运行状态。实际部署时，建议先在测试环境验证配置，再逐步迁移到生产环境。

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