Docker Swarm模式下PostgreSQL容器无法接收TCP请求求助

1. 检查Swarm overlay网络跨节点通信基础 #

• 确认Swarm集群节点间**UDP 4789端口（VXLAN）和TCP 7946端口（节点发现）**已开放，防火墙/安全组不能拦截这两个端口，否则跨节点的TCP流量无法正常传输。
• 执行docker network inspect postgres_network，验证主从容器IP在配置的10.70.1.0/24子网内，同时确认网络Scope为swarm、Driver为overlay。

2. 验证PostgreSQL主节点的监听与访问控制 #

• 进入主节点容器，执行psql -U postgres -c "SHOW listen_addresses;"，确保输出为*（允许所有地址监听）。
• 查看主节点/bitnami/postgresql/data/pg_hba.conf文件，检查是否包含允许从节点网段的复制连接规则，示例规则：

  host    replication     repmgr_username     10.70.1.0/24        scram-sha-256
  

  Bitnami镜像会自动生成该配置，但跨节点部署时可能存在网段匹配偏差。

3. 排查本地挂载卷的冲突问题 #

• 你在主从节点都挂载了/localVol:/bitnami/postgresql，但Swarm跨节点部署时这是节点本地路径，并非共享存储：主节点数据写入primary节点的/localVol，而从节点所在节点的/localVol为空，会导致从节点初始化异常，进而影响连接逻辑。
• 建议改用Swarm支持的共享存储卷（如NFS、GlusterFS），或直接使用Bitnami的bitnami/postgresql-repmgr镜像，该镜像内置repmgr工具，简化HA集群部署。

4. 测试跨节点容器的TCP连通性 #

• 在从节点容器内执行nc -zv postgresql-master 5432，同时在主节点所在Swarm节点上执行tcpdump -i vxlan0 port 5432（或对应overlay网络的接口），查看是否有TCP握手包。
• 如果主节点所在节点能捕获请求，但容器内tcpdump无输出，可能是Swarm ingress网络或端口映射问题：主节点配置了ports: 5432:5432，Swarm会通过ingress暴露端口，但容器间通信应直接用服务名访问容器端口，无需经过ingress，需排查端口冲突或ingress网络异常。

5. 检查Swarm服务的DNS解析 #

• 在从节点容器内执行nslookup postgresql-master，确认返回的是主节点容器IP而非Swarm ingress的VIP。若返回VIP，说明服务网络配置异常，导致从节点连接到ingress VIP而非主容器。
• 尝试用主节点容器的实际IP替换POSTGRESQL_MASTER_HOST环境变量，测试是否能连接，排除DNS解析问题。

6. 查看Bitnami镜像的初始化细节日志 #

• 执行docker service logs -f <postgresql-slave-service-id>，查看从节点启动的完整日志，Bitnami镜像会输出具体的连接失败原因（如认证失败、网段不允许等），而非仅超时提示。

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