Blazor应用Docker化需区分项目类型并采用多阶段构建：Blazor Server用ASP.NET运行时镜像；Blazor WebAssembly Hosted需同时构建Server（含自动打包Client静态文件）与托管；纯WASM可直接用Nginx镜像部署wwwroot。
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挂载，而非硬编码进镜像
基本上就这些。关键不是“能不能跑”，而是“是否最小化、可复现、易维护”——多阶段构建 + 明确职责分离 + 环境解耦，就能稳住 Blazor 的 Docker 化落地。
