microsoft/dotnet-aspnet

特色标签

• 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应用进行了优化。

关注https://github.com/dotnet/dotnet-docker/discussions/categories/announcements%E8%8E%B7%E5%8F%96Docker%E7%9B%B8%E5%85%B3%E7%9A%84.NET%E5%85%AC%E5%91%8A%E3%80%82

使用方法

https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md%E5%B1%95%E7%A4%BA%E4%BA%86%E5%A4%9A%E7%A7%8D%E5%B0%86.NET%E4%B8%8EDocker%E7%BB%93%E5%90%88%E4%BD%BF%E7%94%A8%E7%9A%84%E6%96%B9%E5%BC%8F%E3%80%82%E6%9C%89%E5%85%B3%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E9%98%85.NET%E4%B8%8EDocker%E7%AE%80%E4%BB%8B%E5%92%8C%E5%9C%A8Docker%E5%AE%B9%E5%99%A8%E4%B8%AD%E6%89%98%E7%AE%A1ASP.NET Core。

容器示例：运行Web应用

您可以使用基于https://github.com/dotnet/dotnet-docker/blob/main/samples/aspnetapp/README.md%E7%9A%84%E9%A2%84%E6%9E%84%E5%BB%BAhttps://hub.docker.com/r/microsoft/dotnet-samples/%E5%BF%AB%E9%80%9F%E8%BF%90%E8%A1%8C%E5%AE%B9%E5%99%A8%E3%80%82

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

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

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

注意：从.NET 8开始，ASP.NET Core应用（在官方镜像中）默认监听https://github.com/dotnet/dotnet-docker/blob/6da64f31944bb16ecde5495b6a53fc170fbe100d/src/runtime-deps/8.0/bookworm-slim/amd64/Dockerfile#L7%E3%80%82%E8%BF%99%E4%BA%9B%E7%A4%BA%E4%BE%8B%E4%B8%AD%E7%9A%84%60-p%60%E5%8F%82%E6%95%B0%E5%B0%86%E4%B8%BB%E6%9C%BA%E7%AB%AF%E5%8F%A3%608000%60%E6%98%A0%E5%B0%84%E5%88%B0%E5%AE%B9%E5%99%A8%E7%AB%AF%E5%8F%A3%608080%60%EF%BC%88%60%E4%B8%BB%E6%9C%BA:%E5%AE%B9%E5%99%A8%60%E6%98%A0%E5%B0%84%EF%BC%89%E3%80%82%E6%B2%A1%E6%9C%89%E6%AD%A4%E6%98%A0%E5%B0%84%EF%BC%8C%E5%AE%B9%E5%99%A8%E5%B0%86%E6%97%A0%E6%B3%95%E8%AE%BF%E9%97%AE%E3%80%82ASP.NET Core可配置为监听其他或额外端口。

有关使用HTTPS的方法，请参阅https://github.com/dotnet/dotnet-docker/blob/main/samples/host-aspnetcore-https.md%E3%80%82

镜像变体

.NET容器镜像有多个变体，提供不同的灵活性和部署大小组合。https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-variants.md%E5%8C%85%E5%90%AB%E9%95%9C%E5%83%8F%E5%8F%98%E4%BD%93%E5%8F%8A%E5%85%B6%E7%94%A8%E4%BE%8B%E7%9A%84%E6%91%98%E8%A6%81%E3%80%82

无发行版（Distroless）镜像

.NEThttps://github.com/dotnet/dotnet-docker/blob/main/documentation/distroless.md仅包含.NET所需的最小包集，其他所有内容均被移除。由于其有限的包集，无发行版容器与非无发行版容器相比，具有最小化的安全***面、更小的部署大小和更快的启动时间。它们包含以下特性：

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

.NET为https://github.com/dotnet/dotnet-docker/blob/main/documentation/azurelinux.md%E5%92%8Chttps://github.com/dotnet/dotnet-docker/blob/main/documentation/ubuntu-***ed.md%E6%8F%90%E4%BE%9B%E6%97%A0%E5%8F%91%E8%A1%8C%E7%89%88%E9%95%9C%E5%83%8F%E3%80%82

ASP.NET Core复合镜像

从.NET 8开始，ASP.NET Core复合镜像使用ReadyToRun (R2R)编译优化性能。有关更多信息，请参阅https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-variants.md#composite-net-80%E3%80%82

相关仓库

.NET：

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

.NET Framework：

• https://hub.docker.com/r/microsoft/dotnet-framework/: .NET Framework、ASP.NET和WCF
• https://hub.docker.com/r/microsoft/dotnet-framework-samples/: .NET Framework、ASP.NET和WCF示例

完整标签列表

查看当前标签请访问Microsoft Artifact Registry门户或https://github.com/dotnet/dotnet-docker/blob/main/README.aspnet.md#full-tag-listing%E3%80%82

支持

生命周期

• https://github.com/dotnet/core/blob/main/support.md
• https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md
• https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md

镜像更新政策

• 基础镜像更新：基础镜像（如debian:bookworm-slim、windows/nanoserver:ltsc2022等）更新后12小时内重新构建镜像。
• .NET发布更新：作为发布新.NET版本的一部分重新构建镜像，包括新的主版本、次版本和服务版本。
• 关键CVE更新：按照以下CVE更新政策描述，重新构建镜像以获取关键CVE修复。
• 月度重建：通常在每月第二个星期二重建镜像，以获取低严重性CVE修复。
• 紧急更新：有时可能需要重建镜像以解决关键问题。如果发生这种情况，将根据https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md#fixed-version-tags%E6%9B%B4%E6%96%B0%E6%96%B0%E7%9A%84%E5%9B%BA%E5%AE%9A%E7%89%88%E6%9C%AC%E6%A0%87%E7%AD%BE%E3%80%82

CVE更新政策

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

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

有关遇到.NET镜像中CVE时的处理方法，请参阅https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md%E5%92%8Chttps://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md%E3%80%82

反馈

• https://github.com/dotnet/dotnet-docker/issues/new/choose
• 联系Microsoft支持

许可

• ***声明：容器许可信息
• https://github.com/dotnet/dotnet-docker/blob/main/LICENSE
• https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-artifact-details.md
• Windows基础镜像许可（仅适用于Windows容器）
• Windows Server定价和许可