使用Asp.Net Core构建生产环境Docker镜像及发布方法咨询

阿华AIGC实验室

2026-5-27

为Asp.Net Core构建生产环境Docker镜像的最优方案

我完全理解你的困惑——Asp.Net Core的Docker镜像分开发和生产两类，刚开始确实容易搞混，尤其是Visual Studio默认的配置有时候会让你误以为一直在用build镜像。别担心，下面我就给你讲清楚生产镜像的正确构建和推送方法：

核心原则：用多阶段构建分离编译与运行环境

生产环境绝对不能用aspnetcore-build（现在微软官方统一叫.NET SDK镜像），因为它包含了所有编译工具，体积大而且有安全隐患。正确的做法是多阶段构建：用SDK镜像完成编译和发布，然后把成品复制到轻量的.NET AspNetCore Runtime镜像里，这才是生产环境该用的镜像。

标准的多阶段Dockerfile示例

把项目根目录的Dockerfile替换成下面的内容（注意替换成你的项目名称和对应的.NET版本，比如7.0/6.0）：

# 第一阶段：编译构建（用SDK镜像，包含所有编译工具）
FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src
# 先复制csproj文件并还原依赖，利用Docker缓存加速构建
COPY ["YourAspNetProject.csproj", "."]
RUN dotnet restore "./YourAspNetProject.csproj"
# 复制所有源码文件
COPY . .
WORKDIR "/src/."
# 以Release模式构建项目
RUN dotnet build "YourAspNetProject.csproj" -c Release -o /app/build

# 第二阶段：发布成品
FROM build AS publish
# 发布项目到指定目录，关闭自包含宿主（默认用框架依赖模式，更轻量）
RUN dotnet publish "YourAspNetProject.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 第三阶段：生产镜像（仅包含运行时，体积小、安全）
FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS final
WORKDIR /app
# 从发布阶段复制成品到运行时镜像
COPY --from=publish /app/publish .
# 设置入口点
ENTRYPOINT ["dotnet", "YourAspNetProject.dll"]

验证Visual Studio的发布行为

你提到发布时看到Docker从aspnetcore-build挂载，这大概率是VS的开发调试模式（比如Docker Compose调试）的行为，不是生产发布的最终镜像。要确认生产发布的镜像是否基于aspnet：

用VS完成发布后，打开命令行执行：
```
docker inspect your-image-name | grep "BaseImage"
```
如果输出里是mcr.microsoft.com/dotnet/aspnet:开头，就说明是正确的生产镜像。
如果你想彻底避免混淆，可以直接在VS中选择“使用自定义Dockerfile”发布，确保用的是上面的多阶段配置。

构建并推送生产镜像的步骤

方法1：命令行方式（灵活可控）

进入项目根目录（包含Dockerfile的目录）
构建镜像（替换成你的镜像名和标签）：
```
docker build -t your-registry/your-app:v1.0.0 .
```
推送到容器注册表（比如Docker Hub、Azure ACR等，先确保已经登录）：
```
docker push your-registry/your-app:v1.0.0
```