ASP.NET Core 6 Web API Docker构建后无法运行及端口问题

一、Visual Studio 2022 无法运行项目（Dockerfile 移至根目录后） #

Dockerfile 移到根目录后，VS 默认的项目 Docker 配置路径会失效，按以下步骤修复：

• 右键 Web API 项目 → 「添加」→「Docker 支持」，VS 会自动更新项目配置，指向根目录的 Dockerfile。
• 检查项目 .csproj 文件，确认包含正确的 Docker 上下文配置：

  <DockerfileContext>..\</DockerfileContext>
  <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
  

• 清理解决方案，重新生成后再尝试运行。

二、推送至 ACR 后无法访问 Swagger 页面 #

原因1：Swagger 默认仅在开发环境启用 #

修改 Program.cs，调整 Swagger 启用逻辑，可根据需求选择：

• 临时调试用：强制在所有环境启用 Swagger

  var app = builder.Build();
  
  app.UseSwagger();
  app.UseSwaggerUI();
  
  app.UseAuthorization();
  app.MapControllers();
  app.Run();
  

• 生产环境规范配置：通过环境变量控制，比如在 ACR 部署时设置自定义环境变量 EnableSwagger=true，再在代码中判断启用。

原因2：容器端口监听或映射配置问题 #

• 检查 Dockerfile 是否包含端口暴露指令：EXPOSE 80 443
• 确保 ASP.NET Core 应用监听所有网卡地址，在 Program.cs 中添加：

  app.Run("http://0.0.0.0:80");
  

  或通过环境变量 ASPNETCORE_URLS=http://0.0.0.0:80 设置。

三、VS Code 运行镜像时 80 端口绑定权限错误 #

80 是系统保留端口，普通用户无绑定权限或端口被占用，按以下方案解决：

• 方案1：更换非保留端口运行
  运行容器时映射宿主的非保留端口（如 8080）到容器 80 端口：

  docker run -p 8080:80 myTag:123
  

  之后通过 http://localhost:8080/swagger 访问。

• 方案2：赋予权限绑定低端口（仅 Linux/macOS）
  执行命令允许非 root 用户绑定 1024 以下端口：

  sudo setcap 'cap_net_bind_service=+ep' /usr/bin/dotnet
  

• 方案3：检查端口占用
  Windows 下查询占用进程：

  netstat -ano | findstr ":80"
  

  Linux/macOS 下：

  lsof -i :80
  

  关闭占用进程后重新运行容器。

内容的提问来源于stack exchange，提问作者Robert Green MBA