Docker部署Zabbix需确保server、web前端、数据库三者协同运行，通过自定义bridge网络、健康检查依赖、持久化挂载及正确环境变量实现稳定连通；agent须用host网络并填Server宿主机IP。
用Docker部署Zabbix不是配一堆镜像就完事，关键在组件协同、数据持久和网络连通。核心是把 server、web 前端、数据库三者稳定串起来，再让 agent 能连上、数据能写入、页面能打开。
基础环境与镜像准备
确保宿主机已安装 Docker 和 docker-compose（建议 2.0+），系统内存 ≥2GB，磁盘 ≥20GB。推荐使用官方或社区验证镜像：
- 数据库：mysql:8 或 mariadb:10.6（Zabbix 6.0+ 推荐 MySQL 8.0+）
- Zabbix Server：zabbix/zabbix-server-mysql:alpine-6.4-latest（轻量且更新及时）
- Web 前端：zabbix/zabbix-web-nginx-mysql:alpine-6.4-latest（Nginx + PHP-FPM，比 Apache 更省资源）
- Java Gateway（可选）：zabbix/zabbix-java-gateway:alpine-6.4-latest（监控 JMX 应用时启用）
避免混用不同大版本镜像（如 server 6.4 + web 5.4），否则可能因 API 或 DB schema 不兼容导致启动失败。
docker-compose.yml 关键配置要点
一份可靠的基础编排需明确依赖、网络、卷挂载和环境变量。以下为精简可用结构：
- 用 自定义 bridge 网络（如 zabbix-net），禁用 default 网络，避免容器间通信不可控
- MySQL 容器必须先建库并初始化：通过 init.sql 或 entrypoint 脚本创建 zabbix 用户和 zabbix 数据库，字符集设为 utf8mb4
- Zabbix Server 启动前等待 MySQL 就绪：用 healthcheck + depends_on + condition: service_healthy，不能只靠 restart: always
- 持久化必须做：MySQL 数据目录、Zabbix 配置文件（/etc/zabbix）、前端日志及 SSL 证书均应映射到宿主机路径
- 端口暴露按需开放：Web 前端映射 80/443，Server 的 10051 通常不对外，仅限内部容器通信
首次启动与基础验证
执行 docker-compose up -d 后，分步确认：
- 查容器状态：
docker-compose ps—— 所有服务应为 Up，无 Restarting 或 Exited - 看 MySQL 日志：
docker-compose logs mysql | grep "ready for connections"—— 确认数据库真正就绪 - 进 Server 容器检查连接：
docker-compose exec zabbix-server mysql -h mysql -u zabbix -pzabbixpass -e "show databases;"—— 验证 DB 连通性 - 浏览器访问
http://宿主机IP/zabbix，输入默认账号 Admin/zabbix —— 若页面加载但提示 DB 连接失败，大概率是 Server 容器未等 MySQL 完全 ready 就启动了
常见卡点：MySQL 初始化脚本权限不足、Server 容器里 /etc/zabbix/zabbix_server.conf 中 DBPassword 写错、防火墙拦截 3306 或 80 端口。
添加被监控主机（Agent 方式）
监控其他 Linux 主机，推荐在目标机上直接运行 Zabbix Agent 容器（非安装包），更轻量易管理：
- 运行命令示例：
docker run -d --name zabbix-agent --network host -e ZBX_HOSTNAME="web01" -e ZBX_SERVER_HOST="10.10.20.100" -e ZBX_SERVER_PORT="10051" --restart=always zabbix/zabbix-agent:alpine-6.4-latest - 注意使用 --network host 模式，使 agent 可直接获取宿主机真实 CPU、内存、磁盘指标；若用 bridge 模式，需额外挂载
/proc、/sys、/dev等路径 - ZBX_SERVER_HOST 必须填 Zabbix Server 宿主机的 IP（非容器内网 IP），因为 agent 是跑在另一台机器上的
- 在 Web 界面「Configuration → Hosts → Create host」中填写相同 Host name，并关联模板 Template OS Linux by Zabbix agent
不复杂但容易忽略。
