无法从容器实例访问.NET 8 Web API的技术求助

我创建了一个.NET 8 Web API并部署到容器实例中，但尝试访问时无法从容器实例外部访问。

Dockerfile

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
USER app
WORKDIR /app
EXPOSE 8080
EXPOSE 8081
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
ARG BUILD_CONFIGURATION=Release
WORKDIR /src
COPY ["Net8/Net8.csproj", "Net8/"]
RUN dotnet restore "./Net8/Net8.csproj"
COPY . .
WORKDIR "/src/Net8"
RUN dotnet build "./Net8.csproj" -c $BUILD_CONFIGURATION -o /app/build
FROM build AS publish
ARG BUILD_CONFIGURATION=Release
RUN dotnet publish "./Net8.csproj" -c $BUILD_CONFIGURATION -o /app/publish
/p:UseAppHost=false
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Net8.dll"]

问题解答 #

.NET本身没有限制容器外部访问的默认机制，无法访问的问题基本出在配置或部署环节，核心排查点如下：

• Dockerfile语法错误：publish阶段的/p:UseAppHost=false参数单独成行，会导致发布命令执行失败。正确写法需将参数合并到上一行：

  RUN dotnet publish "./Net8.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false
  

  语法错误可能导致发布产物异常，进而影响服务启动或监听配置。

• 端口映射未配置：Dockerfile中EXPOSE仅声明容器内部端口，不会自动完成内外端口映射。部署时需显式配置映射：

  • 本地运行容器：执行docker run -p 8080:8080 <镜像名>；
  • 云容器实例：在控制台配置端口转发规则，将实例公网端口映射到容器的8080/8081端口。

• Web API监听地址限制：若代码硬编码监听localhost，服务仅能在容器内部访问。可通过两种方式确保监听所有地址：

  • 在Program.cs中配置Kestrel：

    var builder = WebApplication.CreateBuilder(args);
    builder.WebHost.ConfigureKestrel(options =>
    {
        options.ListenAnyIP(8080);
    });
    

  • 设置环境变量ASPNETCORE_URLS=http://*:8080。

• 网络与防火墙限制：云容器实例需额外检查：

  • 是否分配了公网IP或配置了负载均衡访问路径；
  • 安全组/防火墙规则是否允许外部访问目标端口（8080/8081）。

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