直接用 .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.0Runtime 镜像(最终镜像):
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查启动日志,常见是配置文件缺失、连接字符串指向宿主机地址等
基本上就这些。不复杂但容易忽略版本对齐和端口绑定细节。
