在WSL2环境的Windows Docker容器内，如何连接主机网络指定IP？

先排查基础连通性 #

• 先在WSL2终端执行 ping [目标设备IP]，如果无法连通，说明问题出在WSL2与局域网的连通性上，而非Docker容器本身：
  • 检查Windows防火墙：添加允许WSL2子网（可通过WSL内ip addr查看eth0的网段，比如172.17.0.0/16）的出站/入站规则，允许指定端口或全协议流量。
  • 检查目标设备的防火墙：确保目标设备允许来自WSL2子网的IP访问对应端口。

Docker容器层面的配置调整 #

• 无需强制使用network_mode: "host"，但如果想简化网络配置可以尝试启用：
  • 在docker-compose.yml中添加配置：network_mode: "host"
  • 注意：该模式下容器共享的是WSL2的网络栈，而非Windows主机的，仍需确保WSL2能正常访问目标设备。
• 若使用默认bridge网络，容器默认具备外部网络访问能力，若仍无法连通，需检查：
  • Docker daemon未限制容器外部访问（默认无限制）。
  • Windows防火墙未阻止Docker容器所在子网（通常为172.17.0.0/16类网段）的流量。

额外排查点 #

• 确认目标设备的IP、端口正确，且对应服务处于正常监听状态。
• 核实当前WSL版本为WSL2（WSL1与Windows共享网络栈，连通性逻辑不同）。

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