.NET应用容器化关键在于选对基础镜像、写好dockerfile、规避windows/linux运行时差异;推荐.NET6+用Linux容器,需确保SDK与runtime版本完全匹配,使用mcr.microsoft.com/dotnet/sdk:8.0和aspnet:8.0等新镜像,并显式指定OS与架构。

直接用 .NET SDK 自带的 docker 模板就能快速容器化,关键不是“能不能”,而是选对基础镜像、写好 Dockerfile、避开 windows/Linux 运行时差异这几个点。
确认项目类型和目标运行时
.NET 6+ 推荐统一用 Linux 容器(轻量、主流、CI/CD 友好),除非你必须依赖 Windows 特性(比如某些 COM 组件或 iis 模块)。先执行:
dotnet --list-runtimes
看本地有没有 Microsoft.NETCore.app 或 Microsoft.AspNetCore.App 对应版本。Docker 镜像里要用完全匹配的 runtime 版本,否则运行时报错“Could not load file or assembly”。
用 CLI 快速生成 Dockerfile(推荐新手)
在项目根目录(.csproj 所在目录)运行:
dotnet publish -c Release -o ./publish docker build -t myapp:latest .
但更省事的是直接让 SDK 帮你生成标准 Dockerfile:
- 确保已安装 .NET SDK 6.0+ 和 Docker Desktop
- 执行:
dotnet new docker -lang C#(会生成适配当前项目的 Dockerfile) - 它会自动检测是 Web API、Blazor Server 还是 Worker Service,并选用对应多阶段构建模板
手动写 Dockerfile 的核心要点
别照抄网上老教程用 mcr.microsoft.com/dotnet/core/ ——这个仓库已弃用。现在统一用:
- SDK 镜像(构建阶段):
mcr.microsoft.com/dotnet/sdk:8.0 - Runtime 镜像(最终镜像):
mcr.microsoft.com/dotnet/aspnet:8.0(Web 应用)或mcr.microsoft.com/dotnet/runtime:8.0(控制台/Worker) - 务必加
--os linux --arch amd64(或arm64)显式指定平台,避免拉取错架构镜像 - ASP.NET Core 应用默认监听
http://+:80,Dockerfile 里要加EXPOSE 80,启动容器时用-p 8080:80映射
运行与验证容器
构建完镜像后,别急着上 kubernetes,先本地跑通:
docker run -d -p 5000:80 --name myapp-container myapp:latest curl http://localhost:5000/healthz # 看是否返回 200
如果报错“Connection refused”:
- 检查程序里是否用了
UseUrls("http://*:5000")—— 容器里要改成http://+:80 - 确认
Program.cs中没硬编码localhost,DNS 或服务发现要用容器网络名 - 用
docker logs myapp-container查启动日志,常见是配置文件缺失、连接字符串指向宿主机地址等
基本上就这些。不复杂但容易忽略版本对齐和端口绑定细节。