如何在Docker容器中运行.NET项目？构建授权报错求解

错误原因 #

1. 基础镜像地址失效：你使用的microsoft/aspnet是微软旧版镜像仓库地址，该仓库已迁移至Microsoft Container Registry（MCR），原仓库不再维护且可能已被移除，导致Docker无法拉取镜像，触发权限不足/仓库不存在的错误。
2. 镜像版本不匹配（若适用）：如果你的项目是.NET Core/.NET 5+版本，microsoft/aspnet本身只适配.NET Framework的ASP.NET项目，镜像类型完全不匹配。

解决方法 #

1. 替换为官方维护的基础镜像 #

根据项目类型修改Dockerfile：

• **ASP.NET Framework（.NET Framework 4.x）**项目：

  FROM mcr.microsoft.com/dotnet/framework/aspnet:4.8
  ARG source
  WORKDIR /inetpub/wwwroot
  COPY ${source:-obj/Docker/publish} .
  

• **ASP.NET Core/.NET 5+**项目（推荐多阶段构建，减少镜像体积）：

  # 构建阶段：用SDK镜像编译代码
  FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
  WORKDIR /src
  COPY ["EducationWebSite/EducationWebSite.csproj", "EducationWebSite/"]
  RUN dotnet restore "EducationWebSite/EducationWebSite.csproj"
  COPY . .
  WORKDIR "/src/EducationWebSite"
  RUN dotnet build "EducationWebSite.csproj" -c Release -o /app/build
  
  # 发布阶段：生成可部署文件
  FROM build AS publish
  RUN dotnet publish "EducationWebSite.csproj" -c Release -o /app/publish /p:UseAppHost=false
  
  # 运行阶段：用轻量运行时镜像启动服务
  FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS final
  WORKDIR /app
  COPY --from=publish /app/publish .
  ENTRYPOINT ["dotnet", "EducationWebSite.dll"]
  

2. 确保构建命令与上下文正确 #

单独执行docker build时，需进入项目目录或指定正确的上下文路径：

# 进入EducationWebSite目录后执行
docker build -t educationwebsite .
# 或在根目录指定上下文
docker build -t educationwebsite ./EducationWebSite

使用docker-compose构建则直接在docker-compose.yml所在目录执行：

docker-compose build

3. 验证Docker登录状态（按需） #

MCR公开镜像无需登录，但如果涉及私有镜像，需执行docker login mcr.microsoft.com完成授权。

Docker中运行.NET项目的正确步骤 #

• 步骤1：选择匹配的官方镜像
  • .NET Framework项目：使用mcr.microsoft.com/dotnet/framework/aspnet系列镜像（对应.NET Framework版本，如4.8）
  • .NET Core/.NET 5+项目：构建用mcr.microsoft.com/dotnet/sdk，运行用mcr.microsoft.com/dotnet/aspnet，版本与项目的.NET版本一致。
• 步骤2：编写规范的Dockerfile
  • .NET Framework：直接复制Visual Studio发布后的文件到IIS的/inetpub/wwwroot目录
  • .NET Core：采用多阶段构建，分离编译、发布、运行阶段，缩小最终镜像体积。
• 步骤3：构建镜像
  使用docker build命令指定镜像名和上下文，或通过docker-compose build批量构建。
• 步骤4：启动容器
  • 单容器运行：docker run -d -p 8080:80 educationwebsite（将主机8080端口映射到容器80端口）
  • 编排运行：docker-compose up -d（后台启动所有服务）

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