Zabbix Docker容器网络连接问题分析与解决方案

问题现象

在使用RockyLinux 9.4系统部署Zabbix监控系统时，采用Docker Compose方式运行zabbix/zabbix-web-nginx-pgsql:7.0.7-alpine容器后，前端服务出现"recv() failed (104: Connection reset by peer)"错误。该错误表明Nginx作为反向代理时，与上游服务(zabbix-server)的连接被意外重置。

环境配置分析

从部署配置可见，这是一个典型的Zabbix全栈Docker化部署方案，包含三个核心组件：

1. PostgreSQL数据库容器(postgres:16.6-alpine3.21)
2. Zabbix服务端容器(zabbix/zabbix-server-pgsql:7.0.7-alpine)
3. Zabbix前端容器(zabbix/zabbix-web-nginx-pgsql:7.0.7-alpine)

网络端口映射配置为：

• Zabbix Server服务端口：10051
• 前端Web访问端口：18381(HTTP)/18443(HTTPS)
• PostgreSQL数据库端口：15432

根本原因

该错误通常由以下原因导致：

1. 端口映射冲突：前端容器配置的ZBX_SERVER_PORT指向了10051，但实际应该使用映射后的主机端口
2. 容器间通信问题：在Docker默认桥接网络下，容器间应使用服务名称而非主机端口通信
3. 连接超时：后端服务(zabbix-server)启动较慢，前端容器已经尝试建立连接

解决方案

方案一：修正容器间通信配置

修改前端容器的环境变量配置：

environment:
  ZBX_SERVER_HOST: zabbix_server  # 使用Docker服务名而非IP
  ZBX_SERVER_PORT: 10051         # 使用容器内部端口

方案二：调整启动顺序依赖

增加健康检查确保服务可用性：

depends_on:
  zabbix_server:
    condition: service_healthy

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:10051"]
  interval: 30s
  timeout: 10s
  retries: 3

方案三：网络模式优化

建议使用自定义Docker网络：

docker network create zabbix-net

然后在compose文件中为所有服务添加：

networks:
  default:
    external: true
    name: zabbix-net

最佳实践建议

1. 始终使用Docker服务名称进行容器间通信
2. 对于生产环境，建议使用host网络模式或自定义网络
3. 为关键服务添加健康检查机制
4. 考虑使用.env文件管理敏感配置
5. 日志收集建议配置为json-file驱动并设置大小限制

总结

Zabbix在Docker环境中的部署需要注意容器间通信的特殊性。通过合理配置网络和依赖关系，可以避免常见的连接重置问题。对于企业级部署，还应考虑添加监控、日志收集等运维支撑组件，构建完整的可观测性体系。