在 Alpine 上安裝 .NET SDK 或 .NET 執行環境

.NET 在 Alpine 上有支援，本文說明如何在 Alpine 上安裝 .NET。 當 Alpine 版本停止支援時，該版本將不再支援 .NET。

如果你使用 Docker，建議使用 官方的 .NET Docker 映像，而不是自己安裝 .NET。

這很重要

.NET 10 於 2025 年 11 月 11 日發行。 可能需要一些時間，套件才會出現在套件管理員提要中，或者您的特定 Linux 發行版才會包含它。

如果你想開發 .NET 應用程式，請安裝包含執行環境的 SDK。 或者，如果您只需要執行應用程式，請安裝 Runtime。 如果你正在安裝執行環境，我們建議你安裝 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 核心 3.1
  • .NET 核心 3.0
  • .NET 核心 2.2
  • .NET 核心 2.1
  • .NET 核心 2.0

安裝 .NET

安裝 SDK

.NET SDK 允許你用 .NET 開發應用程式。 如果你安裝了 .NET SDK，就不需要安裝對應的執行環境。 要安裝 .NET SDK，請執行以下指令：

sudo apk add dotnet10-sdk

欲了解如何使用 .NET CLI，請參閱 .NET CLI overview。

安裝執行階段

ASP.NET Core 執行時允許你執行那些用 .NET 製作但沒有提供執行環境的應用程式。 以下指令可安裝 ASP.NET Core 執行環境，這是 .NET 最相容的執行環境。 在終端內，執行下列 命令：

sudo apk add aspnetcore10-runtime

作為 ASP.NET Core 執行環境的替代方案，你可以安裝不包含 ASP.NET Core 支援的 .NET 執行環境：將前一個指令中的 aspnetcore10-runtime 替換為 dotnet10-runtime：

sudo apk add dotnet10-runtime

欲了解如何使用 .NET CLI，請參閱 .NET CLI overview。

支援的架構

下表列出目前支援的 .NET 版本及其所支援的 Alpine 架構。 這些版本會持續支援，直到 .NET 版本終止支援或支援 Alpine 架構#。 請注意，只有 x86_64、armv7、aarch64 具備 Microsoft 官方支援。 其他架構由散發維護人員支援，如果有適用於該架構的套件，可以使用 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+

  • CA 憑證
  • libgcc
  • libssl3
  • libstdc++
  • zlib（僅限 .NET 8）
  • ICU-libs 與 ICU-data-full（除非 .NET 應用程式以全球化不變模式運行）
  • tzdata
  • krb5

使用 apk add 命令來安裝相依性。

下一步

  • Last updated on