WSL2后端Docker Desktop下Docker Swarm节点异常求助

问题描述 #

我正在搭建一套用于采集多台树莓派3传感器数据的系统，计划用Docker Compose定义服务并通过Docker Swarm分发。但遇到核心问题：worker节点加入Swarm集群后几秒，在manager节点执行docker node ls就会显示该节点处于down状态，docker node inspect <WORKER-ID>提示heartbeat failure。

已尝试操作 #

• 测试环境：两台同局域网的Windows 11设备，均使用WSL2后端的Docker Desktop；台式机通过以太网连接，Surface Pro 8通过WiFi连接；每次操作前已开放端口2377 TCP、7946 TCP/UDP、4789 UDP
• 首次尝试：台式机执行docker swarm init，用socat做代理转发2378端口到manager的2377，Surface Pro 8通过台式机局域网IP+2378端口加入，结果节点很快down，触发心跳失败
• 后续尝试：交换manager/worker角色、台式机换Ubuntu原生Docker、重装Surface Pro 8的Docker Desktop，问题依旧；仅当Surface Pro 8作为manager并使用socat代理时，worker节点能保持活跃，但未验证overlay网络通信

可能原因分析 #

1. WSL2 NAT网络的限制：WSL2默认采用NAT网络模式，容器网络与宿主机局域网隔离。即使宿主机开放了端口，WSL2内部的Docker服务可能无法持续接收跨节点的心跳包，尤其是跨WiFi/以太网接口时，NAT转发的不对称性会导致心跳中断。
2. Socat代理的局限性：socat仅代理了节点加入所需的2377端口，但Swarm集群建立后，节点间需要通过7946（节点发现）和4789（overlay网络）直接通信，这些端口的流量未被代理，导致加入后心跳无法维持。
3. 跨网络接口的路由问题：以太网与WiFi属于不同的网络接口，局域网内路由可能存在双向通信障碍，导致节点间心跳包无法正常往返，触发超时标记节点为down。

解决方案 #

方案1：配置WSL2使用桥接网络 #

让WSL2直接获取局域网IP，规避NAT带来的通信问题：

1. 在Windows的%UserProfile%\.wslconfig文件中添加配置：

   [wsl2]
   networkMode=bridged
   vmSwitch=你的虚拟交换机名称（可在Hyper-V管理器中查看）
   

2. 重启WSL：执行wsl --shutdown后重新启动WSL
3. 重新初始化Swarm，指定WSL2的局域网IP：docker swarm init --advertise-addr <WSL2-局域网-IP>，worker节点直接通过该IP+2377端口加入，无需socat代理

方案2：确保节点间网络双向可达 #

1. 临时关闭两台设备的防火墙（测试用，确认问题后再配置精准规则），或确保防火墙允许局域网内所有节点的7946、4789端口流量
2. 验证两台设备的WSL2内部IP与宿主机IP互相能ping通，确保网络链路无阻断
3. 初始化Swarm时强制指定局域网IP，避免Docker自动选择NAT内部IP：docker swarm init --advertise-addr <局域网IP>

方案3：统一节点网络连接类型 #

尽量让所有集群节点使用同一类型的网络连接（均用以太网或均用WiFi），减少跨接口的路由冲突。

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