.NET怎么用Docker进行容器化 .NET应用Docker化部署教程

来源:这里教程网 时间:2026-02-21 17:33:43 作者:

直接用 .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
查启动日志,常见是配置文件缺失、连接字符串指向宿主机地址等

基本上就这些。不复杂但容易忽略版本对齐和端口绑定细节。

相关推荐