将 .NET 项目打包成 Docker 镜像需编写 Dockerfile、构建镜像并运行容器。使用多阶段构建减小体积，确保基础镜像与项目版本匹配（如 8.0），通过 COPY 复制代码，ENTRYPOINT 指定启动命令。创建 .dockerignore 排除无关文件，加快构建速度。执行 docker build 和 docker run 命令构建并运行容器，可选推送镜像到仓库。关键点：版本一致、路径正确、端口暴露完整。
将 .NET 项目打包成 Docker 镜像，是现代应用部署的常见做法。整个过程包括编写 Dockerfile、构建镜像、运行容器几个核心步骤。只要配置正确，.NET 应用可以轻松实现跨平台、可移植的部署。
准备项目文件
确保你的 .NET 项目能正常运行，推荐使用 .NET 6 或更高版本，对容器化支持更完善。项目发布前，检查以下内容：
- 项目文件（如 MyApp.csproj）位于根目录
- 包含必要的依赖项和 SDK 引用
- 使用 dotnet publish -c Release 能成功发布
建议在项目根目录下创建一个独立的 Dockerfile 文件，不要放在子目录中。
编写 Dockerfile
Dockerfile 是构建镜像的核心脚本。下面是一个适用于 ASP.NET Core Web API 或普通 .NET 应用的标准示例：
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base WORKDIR /app EXPOSE 80 FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build WORKDIR /src COPY *.csproj ./ RUN dotnet restore COPY . . RUN dotnet publish -c Release -o /app/publish FROM base AS final WORKDIR /app COPY --from=build /app/publish . ENTRYPOINT ["dotnet", "YourAppName.dll"]
说明：
- 基础镜像：使用微软官方镜像，版本需与项目一致（如 6.0、8.0）
- 多阶段构建：先用 SDK 镜像编译，再复制到轻量运行时镜像，减小体积
- COPY . .：复制所有源码，注意排除不必要的文件（使用 .dockerignore）
- ENTRYPOINT：指定启动命令，dll 名称要与实际输出一致
如果你的应用监听 HTTPS 端口，记得添加 EXPOSE 443，并在 ENTRYPOINT 中配置环境变量。
忽略不必要的文件（.dockerignore）
为了加快构建速度并减少镜像体积，建议创建 .dockerignore 文件：
bin/ obj/ .git .vscode/ *.user *.suo Dockerfile .dockerignore
这样可以避免把本地编译产物或 IDE 配置复制进镜像。
构建和运行镜像
打开终端，进入项目根目录，执行以下命令：
-
构建镜像：
docker build -t my-dotnet-app . -
运行容器：
docker run -d -p 8080:80 --name myapp my-dotnet-app -
查看日志：
docker logs myapp
访问 http://localhost:8080 即可看到应用运行结果。
推送镜像到仓库（可选）
如果需要共享或部署到云平台，可推送到 Docker Hub 或私有 registry：
- 登录：docker login
- 打标签：docker tag my-dotnet-app username/my-dotnet-app:latest
- 推送：docker push username/my-dotnet-app:latest
基本上就这些。只要 Dockerfile 写对，.NET 项目打包成镜像并不复杂，关键是版本匹配和路径正确。遇到问题优先检查 dll 名称、端口暴露和文件复制路径。
