Docker化.NET API遇端口错误：Socket Hang Up问题解决求助

1. 确保API监听正确地址 #

.NET 6 默认可能仅监听 localhost，导致容器外部无法访问。需强制服务监听所有网卡地址（0.0.0.0）：

• 方法一：修改Program.cs
  在构建WebApplication时添加Urls配置：

  var builder = WebApplication.CreateBuilder(args);
  // 其他配置逻辑
  builder.WebHost.UseUrls("http://0.0.0.0:5000");
  var app = builder.Build();
  // 中间件配置
  app.Run();
  

• 方法二：通过环境变量设置
  在docker run命令中添加环境变量：

  docker run -p 5000:5000 -e ASPNETCORE_URLS=http://0.0.0.0:5000 webapi:latest
  

  或在Dockerfile的ENTRYPOINT前添加：

  ENV ASPNETCORE_URLS=http://0.0.0.0:5000
  

2. 优化Dockerfile（推荐） #

原Dockerfile使用SDK镜像作为运行环境，建议替换为轻量的ASP.NET运行时镜像，同时移除冗余的dotnet build命令（dotnet publish已包含构建步骤）：

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /app

COPY WebAPI.csproj .
RUN dotnet restore "WebAPI.csproj"

COPY . ./
RUN dotnet publish "WebAPI.csproj" -c Release -o /publish

# 改用ASP.NET运行时镜像作为最终环境
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS final
WORKDIR /app
COPY --from=build /publish .
ENV ASPNETCORE_URLS=http://0.0.0.0:5000
EXPOSE 5000
ENTRYPOINT ["dotnet", "WebAPI.dll"]

3. 验证容器内服务状态 #

• 查看容器日志，确认服务是否正常启动：

  docker logs <容器ID或名称>
  

  日志中需包含类似 Now listening on: http://[::]:5000 的信息，说明监听地址正确。
• 进入容器内部测试：

  docker exec -it <容器ID或名称> bash
  # 容器内执行curl访问API
  curl http://localhost:5000/api/[你的接口路径]
  

  如果容器内也无法访问，说明服务启动失败或代码配置有误，需检查项目依赖或启动逻辑。

4. 排查端口与网络问题 #

• 检查主机端口是否被占用：
  Windows执行netstat -ano | findstr :5000，Linux/macOS执行lsof -i :5000，若端口被占用，更换映射端口：

  docker run -p 5001:5000 webapi:latest
  

  之后访问http://127.0.0.1:5001。
• 临时关闭主机防火墙，确认不是防火墙阻止了请求。

5. 修正Postman代理设置 #

你当前设置的Postman代理为127.0.0.1:5000是错误的，这会导致Postman尝试通过该代理发送请求而非直接访问本地服务：

• 打开Postman设置 → 代理 → 关闭「使用系统代理」和「全局代理」。
• 直接发送请求到http://127.0.0.1:5000/api/[你的接口路径]。

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