Blazor应用基于.NET运行时运行，通过Docker将其打包成镜像后，可以在任意支持Docker的环境中快速部署，避免环境差异导致的运行问题。本文以Blazor WebAssembly应用和Blazor Server应用为例，分别说明Docker镜像的构建和部署方法。
Blazor应用Docker镜像构建准备
首先需要确保本地已经安装好.NET SDK和Docker环境，并且已经有一个可正常运行的Blazor项目。可以通过dotnet --version命令检查.NET SDK版本，通过docker --version命令检查Docker是否安装成功。
Blazor WebAssembly镜像构建
Blazor WebAssembly应用是运行在浏览器端的，最终会生成静态文件，因此可以使用Nginx作为基础镜像来托管这些静态资源。首先在Blazor WebAssembly项目根目录创建Dockerfile文件，内容如下：
# 第一阶段：构建应用 FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build WORKDIR /app # 复制项目文件并还原依赖 COPY *.csproj ./ RUN dotnet restore # 复制所有文件并构建发布版本 COPY . . RUN dotnet publish -c Release -o out # 第二阶段：使用Nginx托管静态文件 FROM nginx:alpine WORKDIR /usr/share/nginx/html # 删除Nginx默认文件 RUN rm -rf * # 复制构建产物 COPY --from=build /app/out/wwwroot . # 复制Nginx配置（如果需要自定义配置） # COPY nginx.conf /etc/nginx/nginx.conf EXPOSE 80
在Dockerfile所在目录执行以下命令构建镜像：
docker build -t blazor-wasm-demo .
构建完成后可以通过docker images命令查看生成的镜像。
Blazor Server镜像构建
Blazor Server应用需要.NET运行时支持，因此可以使用微软官方提供的.NET运行时镜像作为基础镜像。Dockerfile内容如下：
# 第一阶段：构建应用 FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build WORKDIR /app COPY *.csproj ./ RUN dotnet restore COPY . . RUN dotnet publish -c Release -o out # 第二阶段：运行环境 FROM mcr.microsoft.com/dotnet/aspnet:8.0 WORKDIR /app COPY --from=build /app/out . EXPOSE 8080 ENV ASPNETCORE_URLS=http://+:8080 ENTRYPOINT ["dotnet", "BlazorServerDemo.dll"]
同样在项目根目录执行构建命令：
docker build -t blazor-server-demo .
Blazor Docker镜像部署
镜像构建完成后，就可以通过Docker命令启动容器完成部署。
本地测试部署
启动Blazor WebAssembly容器：
docker run -d -p 8081:80 --name blazor-wasm-container blazor-wasm-demo
启动Blazor Server容器：
docker run -d -p 8082:8080 --name blazor-server-container blazor-server-demo
启动后可以通过浏览器访问http://localhost:8081查看Blazor WebAssembly应用，访问http://localhost:8082查看Blazor Server应用。
服务器环境部署
如果需要将镜像部署到远程服务器，可以先将本地镜像推送到Docker镜像仓库，然后在服务器上拉取镜像启动容器。以推送到私有仓库为例：
# 标记镜像 docker tag blazor-server-demo 192.168.0.1:5000/blazor-server-demo # 推送镜像 docker push 192.168.0.1:5000/blazor-server-demo
在服务器上执行拉取和启动命令：
# 拉取镜像 docker pull 192.168.0.1:5000/blazor-server-demo # 启动容器 docker run -d -p 80:8080 --name blazor-server-prod 192.168.0.1:5000/blazor-server-demo
常见问题与解决方法
- 构建时提示依赖还原失败：检查项目中的NuGet源配置是否正确，或者尝试在Dockerfile中添加
RUN dotnet nuget add source https://ipipp.com/api/v2替换默认源 - 容器启动后无法访问：检查端口映射是否正确，防火墙是否开放对应端口，Blazor Server应用需要确认ASPNETCORE_URLS环境变量配置是否正确
- Blazor WebAssembly应用页面空白：检查Nginx配置是否正确，静态文件路径是否匹配，确保COPY命令复制的是wwwroot目录下的所有文件
总结
Blazor应用的Docker镜像构建核心是根据应用类型选择合适的基础镜像，Blazor WebAssembly使用Nginx托管静态文件，Blazor Server使用.NET运行时镜像。通过多阶段构建可以减小最终镜像体积，提升部署效率。部署时只需要保证端口映射正确，就可以快速将应用运行在任意Docker环境中。