同网络下外部设备无法访问Docker容器内托管的ASP.NET Core Web API

1. 检查Docker端口绑定是否仅监听本地回环地址 #

Windows环境下通过Visual Studio启动Docker容器时，默认会将端口绑定到127.0.0.1（仅本地可访问），而非所有网卡地址。

• 验证方法：在宿主机CMD中执行命令 netstat -ano | findstr "61234"
  • 如果输出为 TCP 127.0.0.1:61234 0.0.0.0:0 LISTENING，说明仅绑定了回环地址，外部设备无法访问
  • 正常配置应输出 TCP 0.0.0.0:61234 0.0.0.0:0 LISTENING
• 修复方法：修改docker-compose.yml的端口映射规则，显式指定绑定所有网卡：

  ports:
    - "0.0.0.0:61234:80"
  

2. 排查Visual Studio调试时的配置覆盖问题 #

Visual Studio的Docker调试工具会默认覆盖部分docker-compose配置，优先将端口绑定到本地回环以提升调试安全性，会导致你写的端口映射规则不生效。

• 验证方法：关闭VS调试，在docker-compose.yml所在目录手动执行命令启动容器：

  docker-compose up -d
  

  手动启动后再测试外部设备访问是否正常，若正常则说明是VS调试工具的默认配置导致的问题。
• 修复方法：修改VS Docker调试配置，或者非调试场景手动通过docker-compose命令启动容器。

3. 确认ASP.NET Core服务监听地址未被环境变量覆盖 #

ASP.NET Core的URL配置优先级为：环境变量 > 代码中UseUrls配置，若容器内存在ASPNETCORE_URLS环境变量，会覆盖你代码中写的UseUrls("http://*:80")规则。

• 验证方法：进入运行中的容器，执行命令查看监听状态：

  # 进入容器
  docker exec -it <你的容器ID/名称> bash
  # 安装网络工具
  apt update && apt install -y net-tools
  # 查看端口监听
  netstat -tulpn | grep dotnet
  

  若dotnet进程监听的是127.0.0.1:80而非0.0.0.0:80，说明监听地址配置错误。
• 修复方法：在docker-compose.yml的environment节点显式添加URL配置，强制覆盖环境变量：

  environment:
    - ASPNETCORE_ENVIRONMENT=Development
    - ASPNETCORE_URLS=http://+:80
  

4. 重新验证Windows防火墙规则 #

你之前排除防火墙的逻辑存在问题：直接运行程序时，入站请求命中的是dotnet.exe的防火墙规则；运行在Docker中时，入站请求先由Docker Desktop的 backend 进程接收，再转发到容器，之前的规则不适用该场景。

• 验证方法：临时关闭Windows Defender防火墙，测试外部设备是否可以访问，若可以访问则说明是防火墙规则问题。
• 修复方法：添加入站规则，允许61234端口的TCP入站请求，或者给C:\Program Files\Docker\Docker\resources\com.docker.backend.exe添加允许所有入站请求的规则。

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