在 Alpine 上安装 .NET SDK 或 .NET 运行时

Alpine 支持.NET，本文介绍如何在 Alpine 上安装.NET。 当 Alpine 版本不受支持时，该版本不再支持.NET。

如果使用 Docker，请考虑使用 官方.NET Docker 映像而不是自行安装.NET。

重要

.NET 10 于 2025 年 11 月 11 日发布。 包可能需要一段时间才会出现在包管理器源中，或者你的特定 Linux 发行版才会包含它。

如果要开发.NET应用，请安装 SDK（包括运行时）。 或者，如果只需运行应用程序，请安装运行时。 如果要安装运行时，建议安装 ASP.NET Core Runtime，因为它同时包括.NET和 ASP.NET Core运行时。

使用 dotnet --list-sdks 和 dotnet --list-runtimes 命令查看安装的版本。 有关详细信息，请参阅 如何检查是否已安装.NET。

支持的发行版

下表列出了当前支持的.NET版本及其支持的 Alpine 版本。 这些版本一直受支持，直到 .NET 版本终止支持或 Alpine 版本生命周期终止。

高山 支持版本 在 Package Manager 中可用
3.23 10, 9, 8 10, 9, 8
3.22 10, 9, 8 9, 8
3.21 10, 9, 8 9, 8

不再支持以下版本的 .NET ❌：

  • .NET 7
  • .NET 6
  • .NET 5
  • .NET Core 3.1
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

安装.NET

安装 SDK

.NET SDK 允许使用 .NET 开发应用。 如果安装 .NET SDK，则无需安装相应的运行时。 若要安装 .NET SDK，请运行以下命令：

sudo apk add dotnet10-sdk

若要了解如何使用 .NET CLI，请参阅 .NET CLI 概述。

安装运行时

ASP.NET Core运行时允许您运行那些未包含运行时的.NET应用程序。 以下命令安装 ASP.NET Core运行时，这是.NET最兼容的运行时。 在终端中，运行以下命令：

sudo apk add aspnetcore10-runtime

作为 ASP.NET Core 运行时的替代方法，可以安装不包含 ASP.NET Core支持的 .NET Runtime：将上一命令中的 aspnetcore10-runtime 替换为 dotnet10-runtime：

sudo apk add dotnet10-runtime

若要了解如何使用 .NET CLI，请参阅 .NET CLI 概述。

支持的体系结构

下表列出了当前支持的.NET版本及其支持的 Alpine 体系结构。 这些版本一直受支持，直到 .NET 版本达到支持终止或 Alpine 架构得到支持。 请注意，Microsoft 仅正式支持x86_64、armv7、aarch64。 分发维护程序支持其他体系结构，而且如果相应体系结构具有可用的包，则可以使用 apk 包管理器进行安装。

体系结构 .NET 10 .NET 9 .NET 8
x86_64 3.21, 3.22, 3.23 3.21, 3.22, 3.23 3.21, 3.22, 3.23
x86 无 无 无
aarch64 3.21, 3.22, 3.23 3.21, 3.22, 3.23 3.21, 3.22, 3.23
armv7 3.21, 3.22, 3.23 3.21, 3.22, 3.23 3.21, 3.22, 3.23
armhf 无 无 无
s390x 无 无 无
ppc64le 无 无 无
riscv64 无 无 无

安装预览版本

.NET的预览版和候选版本在包存储库中不可用。 可以通过以下方式之一安装 .NET 的预览版和发布候选版：

删除预览版本

使用包管理器管理.NET的安装时，如果以前安装了预览版，可能会遇到冲突。 包管理器可将非预览版解释为早期版本的.NET。 若要安装非预览版本，需要首先卸载预览版本。 有关卸载.NET的详细信息，请参阅如何删除.NET运行时和 SDK。

依赖项

使用包管理器进行安装时，将为你安装这些库。 但是，如果手动安装.NET或发布自包含应用，则需要确保已安装这些库：

3.21+

使用 apk add 命令安装依赖项。

后续步骤

  • 上次更新时间为