Docker Compose网络配置：容器互联规则与Zabbix连接问题排查

核心通信规则说明 #

1. 互联不需要links或固定IP #

• links是Docker 1.9版本之前的遗留功能，仅在默认bridge网络下生效，作用是单向往容器/etc/hosts写入静态解析记录。Compose v2及以上版本使用自定义bridge网络时，默认内置DNS服务发现能力，完全不需要配置links即可实现同网络容器互联。互相配置links触发的循环链接报错，本质是这个过时机制的依赖缺陷，直接删除所有links配置即可解决。
• 不需要给容器手动指定固定IP。接入同一自定义网络的容器会自动获得DNS解析，手动配置固定IP属于多余操作，还会提升后续维护成本。

2. 容器互访的地址选用规则 #

• 禁止使用docker ps -a输出的实际容器名访问：该名称是Docker全局容器标识，仅在默认bridge网络下可被识别，Compose自定义网络不会为该名称自动配置DNS解析，使用后大概率出现解析失败。
• 优先使用docker-compose.yml中定义的服务名访问：同自定义网络下，Compose会自动为每个服务名配置DNS解析，直接指向对应服务的容器IP，是最稳定、最推荐的访问方式。
• 若在服务networks配置段自定义了aliases（网络别名），也可以直接用别名访问，解析优先级和服务名一致。
• links字段下配置的service:alias别名规则属于过时方案，本质是静态写入hosts记录，完全可以被自定义网络的原生DNS能力替代，不需要额外配置。

当前Zabbix配置的故障修复方案 #

按以下步骤调整即可解决跨容器连接拒绝问题：

1. 删除zabbix-agent服务下的整个links配置段，消除循环链接风险，该配置在自定义网络下无任何作用。
2. 确认网络归属一致性：当前zabbix-server、zabbix-agent都接入了zbx_net_backend网络，符合通信前提，不需要调整网络配置。
3. 修正Zabbix环境变量中的地址配置：
   • zabbix-agent侧的ZBX_SERVER_HOST参数填zabbix-server，不要填127.0.0.1/localhost：你给zabbix-agent配置了pid: "host"，容器内的127.0.0.1指向宿主机网络命名空间，不会指向zabbix-server容器，这是连接拒绝的最常见诱因。
   • zabbix-server侧配置监控agent的地址填zabbix-agent，对应端口用10050即可。
4. 容器间通信直接使用容器内部监听端口，不需要使用ports段映射到宿主机的端口：比如agent访问server用zabbix-server:10051即可，ports段的端口映射仅用于宿主机/外部网络访问容器，不影响内部通信。

修正后的核心配置片段参考：

zabbix-agent:
  image: zabbix/zabbix-agent:centos-6.0-latest
  ports:
   - "10050:10050"
  # 移除原有links配置段
  volumes:
   - /etc/localtime:/etc/localtime:ro
   - /etc/timezone:/etc/timezone:ro
   - ./zbx_env/etc/zabbix/zabbix_agentd.d:/etc/zabbix/zabbix_agentd.d:ro
   - ./zbx_env/var/lib/zabbix/modules:/var/lib/zabbix/modules:ro
   - ./zbx_env/var/lib/zabbix/enc:/var/lib/zabbix/enc:ro
   - ./zbx_env/var/lib/zabbix/ssh_keys:/var/lib/zabbix/ssh_keys:ro
  deploy:
   resources:
    limits:
     cpus: '0.2'
     memory: 128M
    reservations:
     cpus: '0.1'
     memory: 64M
   mode: global
  env_file:
   - ./env_vars/.env_agent
  privileged: true
  pid: "host"
  networks:
   zbx_net_backend:
    aliases:
     - zabbix-agent
     - zabbix-agent-passive
     - zabbix-agent-centos
  stop_grace_period: 5s
  labels:
   com.zabbix.description: "Zabbix agent"
   com.zabbix.company: "Zabbix LLC"
   com.zabbix.component: "zabbix-agentd"
   com.zabbix.os: "centos"

内容的提问来源于stack exchange，提问作者user19413311