Blazor Docker 镜像构建和部署方法

Blazor应用Docker化需区分项目类型并采用多阶段构建：Blazor Server用ASP.NET运行时镜像；Blazor WebAssembly Hosted需同时构建Server（含自动打包Client静态文件）与托管；纯WASM可直接用Nginx镜像部署wwwroot。

Blazor Docker 镜像构建和部署方法第1张

Blazor 应用（尤其是 Blazor Server 或 Blazor WebAssembly Hosted）打包进 Docker 镜像并部署，核心是分清构建阶段与运行阶段，合理利用多阶段构建减少镜像体积，同时确保静态资源、服务端逻辑和依赖项正确就位。

确认项目类型再选构建策略

Blazor Server 和 Blazor WebAssembly Hosted 的部署方式差异较大，直接影响 Dockerfile 写法：

Blazor Server：.NET 后端 + SignalR 实时连接，需完整 .NET 运行时，Docker 镜像基于 mcr.microsoft.com/dotnet/aspnet（运行时）或 sdk（构建用）
Blazor WebAssembly Hosted：包含三个项目（Client、Server、Shared），其中 Client 是纯静态文件（.dll + .wasm + index.html），可由 Nginx/Apache 托管；Server 是 ASP.NET Core API，需 .NET 运行时
独立的 Blazor WebAssembly（非 Hosted）无需后端镜像，只需一个轻量 Web 服务器镜像（如 nginx:alpine）托管 wwwroot 目录即可

标准多阶段构建（以 Blazor WebAssembly Hosted 为例）

推荐使用 SDK 镜像构建，再将发布产物复制到精简运行时镜像中。假设解决方案名为 MyApp.sln，Server 项目为 MyApp.Server：

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY *.sln .
COPY MyApp.Client/*.csproj ./MyApp.Client/
COPY MyApp.Server/*.csproj ./MyApp.Server/
COPY MyApp.Shared/*.csproj ./MyApp.Shared/
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish MyApp.Server.csproj

FROM mcr.microsoft.com/dotnet/aspnet:8.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "MyApp.Server.dll"]

注意：dotnet publish 会自动打包 Client 的静态文件到 Server 的 wwwroot 下（前提是 Client 项目已正确引用并配置在 Server 的 Program.cs 中，例如 app.UseBlazorFrameworkFiles() 和 app.MapFallbackToFile("index.html")）。

纯静态 Blazor WASM 的极简部署

如果只部署 Client（比如通过 CI 推送到 CDN 或静态站点），可用 Nginx 快速起服务：

FROM nginx:alpine
COPY MyApp.Client/bin/Release/net8.0/wwwroot/ /usr/share/nginx/html/
COPY nginx.conf /etc/nginx/nginx.conf

其中 nginx.conf 需启用 history 模式支持（避免刷新 404）：

location / {
  try_files $uri $uri/ /index.html;
}

部署注意事项

环境变量：用 --env ASPNETCORE_ENVIRONMENT=Production 启动容器，确保日志和错误页行为符合生产要求
端口映射：默认暴露 8080 或 5000，启动时加 -p 80:8080；若用反向代理（如 Nginx/Traefik），Server 容器可只监听内部端口
HTTPS：不建议在容器内直接配 HTTPS，推荐由前置负载均衡器或反向代理统一处理 TLS 终止
挂载配置：敏感配置（如 ConnectionStrings）建议通过 -v /host/appsettings.prod.json:/app/appsettings.json 挂载，而非硬编码进镜像