特色标签

• 9.0 (标准支持)
  • docker pull mcr.microsoft.com/dotnet/aspnet:9.0
• 8.0 (长期支持)
  • docker pull mcr.microsoft.com/dotnet/aspnet:8.0

关于

此镜像包含ASP.NET Core和.NET运行时及库，针对在生产环境中运行ASP.NET Core应用进行了优化。

关注讨论区获取Docker相关的.NET公告。

使用方法

.NET Docker示例展示了多种将.NET与Docker结合使用的方式。有关更多信息，请参阅.NET与Docker简介和在Docker容器中托管ASP.NET Core。

容器示例：运行Web应用

您可以使用基于ASP.NET Core示例的预构建.NET Docker镜像快速运行容器。

输入以下命令运行示例Web应用：

console
docker run -it --rm -p 8000:8080 --name aspnetcore_sample mcr.microsoft.com/dotnet/samples:aspnetapp

应用启动后，在Web浏览器中导航至http://localhost:8000。您也可以从另一台机器通过本地IP地址（如[***]）查看容器中运行的ASP.NET Core站点。

注意：从.NET 8开始，ASP.NET Core应用（在***镜像中）默认监听8080端口。这些示例中的-p参数将主机端口8000映射到容器端口8080（主机:容器映射）。没有此映射，容器将无法访问。ASP.NET Core可配置为监听其他或额外端口。

有关使用HTTPS的方法，请参阅使用Docker通过HTTPS托管ASP.NET Core镜像。

镜像变体

.NET容器镜像有多个变体，提供不同的灵活性和部署大小组合。镜像变体文档包含镜像变体及其用例的摘要。

无发行版（Distroless）镜像

.NET无发行版容器镜像仅包含.NET所需的最小包集，其他所有内容均被移除。由于其有限的包集，无发行版容器与非无发行版容器相比，具有最小化的安全***面、更小的部署大小和更快的启动时间。它们包含以下特性：

• .NET应用所需的最小包集
• 默认非root用户
• 无包管理器
• 无shell

.NET为Azure Linux和Ubuntu (***ed)提供无发行版镜像。

ASP.NET Core复合镜像

从.NET 8开始，ASP.NET Core复合镜像使用ReadyToRun (R2R)编译优化性能。有关更多信息，请参阅镜像变体文档中的复合镜像部分。

相关仓库

.NET：

• dotnet: .NET
• dotnet/sdk: .NET SDK
• dotnet/runtime: .NET运行时
• dotnet/runtime-deps: .NET运行时依赖项
• dotnet/monitor: .NET监控工具
• dotnet/aspire-dashboard: .NET Aspire仪表板
• dotnet/nightly/aspnet: ASP.NET Core运行时（预览版）
• dotnet/samples: .NET示例

.NET Framework：

• dotnet/framework: .NET Framework、ASP.NET和WCF
• dotnet/framework/samples: .NET Framework、ASP.NET和WCF示例

完整标签列表

查看当前标签请访问Microsoft Artifact Registry门户或GitHub。

支持

生命周期

• Microsoft对.NET的支持
• 支持的容器平台政策
• 支持的标签政策

镜像更新政策

• 基础镜像更新：基础镜像（如debian:bookworm-slim、windows/nanoserver:ltsc2022等）更新后12小时内重新构建镜像。
• .NET发布更新：作为发布新.NET版本的一部分重新构建镜像，包括新的主版本、次版本和服务版本。
• 关键CVE更新：按照以下CVE更新政策描述，重新构建镜像以获取关键CVE修复。
• 月度重建：通常在每月第二个星期二重建镜像，以获取低严重性CVE修复。
• 紧急更新：有时可能需要重建镜像以解决关键问题。如果发生这种情况，将根据固定版本标签文档更新新的固定版本标签。

CVE更新政策

.NET容器镜像会定期监控CVE的存在。当满足以下条件时，将重建给定镜像以获取CVE修复：

• 检测到镜像包含CVSS评分“Critical”的CVE
• 且该CVE存在于我们Dockerfile层中添加的包中（即CVE存在于我们显式安装的包或其任何传递依赖项中）
• 且受影响的基础镜像仓库中存在该包的CVE修复。

有关遇到.NET镜像中CVE时的处理方法，请参阅安全政策和容器漏洞工作流。

反馈

• 提交issue
• 联系Microsoft支持

许可

• ***声明：容器许可信息
• .NET许可
• Linux镜像内容许可信息
• Windows基础镜像许可（仅适用于Windows容器）
• Windows Server定价和许可