GCP上Docker Swarm集群Redis服务跨节点连接故障排查求助

问题分析与解决步骤 #

1. 修正Redis绑定地址

默认Redis镜像仅绑定127.0.0.1，会导致Swarm集群内跨节点容器无法通过集群网络访问。需修改启动命令让Redis绑定所有网卡：

version: "3.8"
services:
  redis:
    image: redis
    command: redis-server --bind 0.0.0.0  # 新增该行，允许外部访问
    ports:
      - 6379:6379
    networks:
      - services
    volumes:
      - /opt/redis:/data
    deploy:
      restart_policy:
        condition: on-failure
        delay: 5s
        max_attempts: 3
        window: 120s
      placement:
        constraints:
          - node.labels.type == manager
networks:
  services:
    driver: overlay  # 显式指定为Swarm overlay网络

2. 使用Swarm服务名访问Redis

跨节点服务必须通过服务名（此处为redis）访问，而非管理节点IP。Swarm的overlay网络会自动提供服务发现，其他服务连接地址应为redis:6379，而非[管理节点IP]:6379。

3. 验证集群网络连通性

• 检查services网络类型：

  docker network inspect services
  

  确认输出中Driver为overlay、Scope为swarm。
• 在其他节点的容器内测试服务可达性：

  ping redis  # 验证服务发现
  telnet redis 6379  # 验证端口连通
  

4. 确认Swarm节点间必备端口开放

除6379外，GCP防火墙需开放Swarm集群通信的核心端口：

• TCP 2377（集群管理）
• TCP/UDP 7946（节点间通信）
• UDP 4789（overlay网络流量）

5. 更新服务并验证

修改配置后重新部署服务：

docker stack deploy -c docker-compose.yml [你的栈名称]

在其他节点的服务容器内测试Redis连接：

redis-cli -h redis ping

返回PONG则表示连接正常。

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