Windows 如何排查 Docker Desktop 容器端口映射到宿主机失败故障

Docker Desktop 默认将容器端口绑定到 127.0.0.1，导致局域网 IP 无法访问；可通过启用 host 网络、修改端口映射为 0.0.0.0:8080 或检查防火墙/WSL2 配置解决。

Windows 上 Docker Desktop 容器端口映射到宿主机失败，常见表现是：localhost 能访问，但本机局域网 IP（如 192.168.1.105）或外部设备无法访问。这不是容器没运行、也不是应用挂了，而是 Docker Desktop 的网络行为限制导致的——它默认只把映射端口绑定到 127.0.0.1，不自动绑定到宿主机其他 IP 地址。

确认是否为 localhost 专属绑定问题

先验证现象：在宿主机浏览器打开 http://localhost:8080（能通），再尝试用本机局域网 IP 访问 http://192.168.1.105:8080（不通）。如果前者成功后者失败，大概率就是 Docker Desktop 的默认绑定策略所致。

1. 运行 netstat -ano | findstr :8080，看输出中监听地址是 127.0.0.1:8080 还是 0.0.0.0:8080
2. 如果是 127.0.0.1，说明端口没暴露给外部网络接口，需继续排查配置

检查 Docker Desktop 是否启用 host 网络支持

从 Docker Desktop 4.34+ 开始，Windows 版本支持真正的 host 模式（需手动开启）。若未启用，--network host 在 Windows 上实际无效。

1. 打开 Docker Desktop → Settings → General → 勾选 Enable host networking
2. 重启 Docker Desktop
3. 启动容器时显式使用 --network host，例如：docker run -d --network host -p 8080:80 nginx
4. 注意：host 模式下，容器直接使用宿主机网络栈，localhost:8080 和 192.168.x.x:8080 都应可用

验证防火墙与 WSL2 网络配置冲突

即使端口映射正确，Windows 防火墙或 WSL2 的网络设置也可能拦截流量。

1. 检查 Windows 防火墙是否放行目标端口：打开“高级安全 Windows 防火墙”→ 入站规则 → 查找对应端口规则，或临时关闭防火墙测试
2. 检查 %USERPROFILE%wslconfig 文件中是否有干扰项，例如：

   networkingMode=mirrored 或 hostAddressLoopback=true —— 这些实验性配置可能导致端口绑定异常，建议注释掉并重启 WSL：wsl --shutdown

3. 确认 WSL2 发行版（如 Ubuntu）中 /etc/resolv.conf 未被手动修改，避免 DNS 或路由异常间接影响连接

绕过限制：显式绑定到 0.0.0.0（推荐临时方案）

如果不想改 host 模式或调整 WSL 配置，可强制让 Docker Desktop 将端口绑定到所有接口。

1. 在 docker run 中明确指定宿主机 IP：docker run -d -p 0.0.0.0:8080:80 nginx
2. 在 docker-compose.yml 中写成：- "0.0.0.0:8080:80"（注意引号和格式）
3. 该写法会覆盖 Docker Desktop 默认的 127.0.0.1 绑定，使端口对局域网可见
4. 验证方式同上：用 netstat -ano | findstr :8080 确认监听地址变为 0.0.0.0:8080