WSL2环境下Docker容器NestJS服务外部无法访问求助

1. 确认端口映射是否正确生效 #

• 执行docker ps，查看目标容器的PORTS列，确认显示为0.0.0.0:3000->3000/tcp或:::3000->3000/tcp。如果显示为127.0.0.1:3000->3000/tcp，说明端口仅绑定到WSL的本地回环，外部无法访问。
• 用docker inspect <容器ID> | grep -A 10 "Ports"查看端口绑定详情，确认HostIp为0.0.0.0而非127.0.0.1。

2. 验证WSL2网络连通性 #

• 在WSL Ubuntu终端中，用WSL的实际IP访问服务：curl http://$(hostname -I | cut -d' ' -f1):3000/ping。如果能正常返回pong，说明服务本身正常，问题出在localhost转发；如果仍拒绝连接，继续排查服务或容器配置。
• Windows端尝试直接访问WSL的IP（如http://172.x.x.x:3000/ping），若能通，可尝试重启WSL修复localhost转发：执行wsl --shutdown后重新打开终端。

3. 确认NestJS服务监听配置 #

• 检查代码中监听逻辑，确保明确指定0.0.0.0，例如：

  async function bootstrap() {
    const app = await NestFactory.create(AppModule);
    await app.listen(3000, '0.0.0.0');
  }
  

• 进入容器内部执行netstat -tulpn | grep 3000，确认服务绑定的地址是0.0.0.0:3000，而非127.0.0.1:3000。

4. 排查防火墙/安全软件干扰 #

• Windows防火墙：检查是否允许Docker Desktop的网络请求，或手动添加入站规则，允许3000端口的TCP流量。
• WSL内部防火墙：执行sudo iptables -L查看规则，若有拦截可临时关闭测试：sudo ufw disable，测试后再按需恢复。

5. 检查Docker Desktop的WSL集成配置 #

• 打开Docker Desktop设置，进入Resources > WSL Integration，确认目标Ubuntu发行版已开启集成开关。
• 重启Docker Desktop和WSL，确保配置生效。

内容的提问来源于stack exchange，提问作者Gipyo.Choi