Windows环境下无法连接Docker网络问题排查求助

1. 服务端监听地址配置错误 #

非Docker环境下程序可能默认监听127.0.0.1（仅本地回环），但容器内的127.0.0.1仅指向容器自身，宿主机或外部无法访问。必须让服务端监听0.0.0.0（所有可用网卡）：

• 检查服务端代码的监听配置：比如Python Flask需写app.run(host='0.0.0.0', port=8080)，Java服务要绑定0.0.0.0而非localhost。
• 进入容器内部，用netstat -ano（Windows容器）或ss -tulpn（Linux容器）查看端口状态，确认是否是0.0.0.0:8080在监听。

2. Docker端口映射未正确生效 #

• 执行docker ps查看容器端口映射，确认输出包含0.0.0.0:8080->8080/tcp或[::]:8080->8080/tcp。如果显示127.0.0.1:8080->8080/tcp，说明仅绑定了宿主机回环，跨设备或容器内客户端无法访问。
• 检查宿主机防火墙是否拦截8080端口，暂时关闭防火墙测试连接是否恢复。

3. Windows环境特殊网络差异（WSL2 vs 原生Docker） #

• WSL2后端Docker：容器内访问宿主机不能用localhost，需用WSL2网络中的宿主机IP（可通过cat /etc/resolv.conf查看nameserver字段）或host.docker.internal域名；若客户端在Windows原生环境，需确认WSL2的端口转发是否正常。
• Hyper-V后端原生Docker：客户端用localhost:8080或宿主机局域网IP即可访问；若客户端在另一个容器内，需用服务端容器的名称/IP（同一网络下）连接，而非宿主机的localhost:8080。

4. 服务端程序未正常启动 #

执行docker logs <容器ID/名称>查看日志，确认服务端是否成功启动。如果程序因依赖缺失、配置错误等原因未启动，端口自然无法接受连接。

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