为何Docker使用Linux容器时无法在Win10设备上搭建Docker Swarm？

这问题我之前帮不少人排查过，其实核心是Windows上Docker Linux容器模式的网络栈和Windows容器不一样导致的——别担心，完全可以用Linux容器搭建Docker Swarm集群，我给你拆解下原因和解决办法：

为什么Windows容器模式能成功，Linux容器不行？ #

Docker在Windows上运行Linux容器时，是依赖WSL2（或者旧版本的Hyper-V虚拟机）作为底层运行环境的，这会带来一层额外的网络隔离：

• Windows容器模式：Docker直接复用Windows主机的网络栈，Swarm需要的端口（2377/tcp、7946/tcp/udp、4789/udp）直接绑定在你的物理网卡上，其他节点在同一网络里能直接访问，所以关闭防火墙后就能正常连接。
• Linux容器模式：Docker的服务其实运行在WSL2的虚拟系统里，端口默认绑定在WSL2的内部虚拟网卡上，而不是Windows主机的物理网卡。哪怕你关闭了Windows主机的防火墙，WSL2内部的防火墙规则、或者Windows和WSL2之间的网络转发没配置好，都会导致其他节点无法连接到WSL里的Swarm管理节点，出现超时或不可用的错误。

如何让Linux容器模式下的Swarm正常工作？ #

你只需要调整网络配置，让Swarm的端口能被同一网络的其他节点访问到，具体步骤如下：

1. 获取正确的IP地址
   • 先查WSL2的内部IP：在WSL终端里执行ip addr，找到eth0对应的inet地址（比如172.18.0.2）。
   • 或者直接用Windows主机的物理网卡IP：在CMD里执行ipconfig找到本地局域网的IP（比如192.168.1.100）。
2. 初始化Swarm时指定对外暴露的地址
   不要用默认的localhost或者WSL内部IP，而是用能被其他节点访问到的IP，执行：

   docker swarm init --advertise-addr <你的物理网卡IP或WSL2对外可达IP>
   

   这样Swarm会把这个IP作为集群的通信地址，其他节点就能正确连接。
3. 配置端口转发（如果需要）
   如果其他节点无法直接访问WSL2的IP，你可以在Windows主机上配置端口转发，把物理网卡的Swarm端口转发到WSL2内部：
   在CMD里以管理员身份执行：

   netsh interface portproxy add v4tov4 listenaddress=<Windows物理IP> listenport=2377 connectaddress=<WSL2内部IP> connectport=2377
   netsh interface portproxy add v4tov4 listenaddress=<Windows物理IP> listenport=7946 connectaddress=<WSL2内部IP> connectport=7946
   netsh interface portproxy add v4tov4 listenaddress=<Windows物理IP> listenport=4789 connectaddress=<WSL2内部IP> connectport=4789
   

   （别忘了UDP端口也需要转发，针对7946和4789的UDP端口，可通过Windows防火墙添加允许入站的UDP规则）
4. 开放WSL2内部的防火墙
   如果你用的是Ubuntu等带ufw的WSL发行版，需要开放Swarm的端口：

   sudo ufw allow 2377/tcp
   sudo ufw allow 7946/tcp
   sudo ufw allow 7946/udp
   sudo ufw allow 4789/udp
   sudo ufw reload
   

   或者临时关闭WSL内部防火墙测试：sudo ufw disable

总结 #

Linux容器模式完全可以搭建Docker Swarm集群，只是因为WSL2的网络隔离特性，需要额外配置端口转发和正确的Swarm广告地址，而Windows容器模式因为直接使用主机网络，所以不需要这些额外操作就能正常工作。按照上面的步骤调整后，你应该就能在Linux容器模式下成功搭建Swarm集群了。

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