共用方式為

在 Alpine 上安裝 .NET SDK 或 .NET 執行階段

  • 發行項

重要

.NET 8 於 2023 年 11 月 14 日發行。 套件可能需要一些時間才能出現在套件管理員摘要中。

Alpine 支援 .NET，本文說明如何在 Alpine 上安裝 .NET。 當某個 Alpine 版本不受支援時，該版本就不再支援 .NET。

如果您使用 Docker，請考慮使用官方 .NET Docker 映像，而不是自行安裝 .NET。

如果您想要開發 .NET 應用程式，請安裝 SDK (其中包含執行階段)。 或者，如果您只需要執行應用程式，請安裝 Runtime。 如果您要安裝執行階段，建議您安裝 ASP.NET Core 執行階段，因為 .NET 和 ASP.NET Core 執行階段都包含在內。

使用 dotnet --list-sdks 和 dotnet --list-runtimes 命令來查看已安裝的版本。 如需詳細資訊，請參閱如何檢查是否已安裝 。

Alpine 套件管理員支援安裝 .NET 的某些版本。 如果 .NET 套件無法使用，您必須以下列其中一種替代方式安裝 .NET：

安裝 .NET 8

Alpine 套件存放庫的預設分支中尚未提供 .NET 8。 使用 edge 分支來安裝 .NET 8。 或者，使用下列其中一種方式來安裝 .NET 8：

若要了解如何使用 .NET CLI，請參閱 .NET CLI 概觀。

安裝 .NET 6

安裝 SDK

.NET SDK 可讓您使用 .NET 開發應用程式。 如果您安裝 .NET SDK，則不需要安裝對應的執行階段。 若要安裝 .NET SDK，請執行下列命令：

sudo apk add dotnet6-sdk

若要了解如何使用 .NET CLI，請參閱 .NET CLI 概觀。

安裝執行階段

ASP.NET Core 執行階段可讓您執行使用未提供執行階段之 .NET 建立的應用程式。 下列命令會安裝 ASP.NET Core 執行階段，這是與 .NET 相容性最高的執行階段。 在終端內，執行下列 命令：

sudo apk add aspnetcore6-runtime

ASP.NET Core 執行階段的替代方案是安裝 .NET 執行階段，後者不包含 ASP.NET Core 支援。 若要安裝，將先前命令中的 aspnetcore6-runtime 取代為 dotnet6-runtime：

sudo apk add dotnet6-runtime

若要了解如何使用 .NET CLI，請參閱 .NET CLI 概觀。

支援的發行版本

下表列出目前支援的 .NET 版本及予以支援的 Alpine 版本。 這些版本會持續獲得支援，.NET 版本的支援終止或 Alpine 版本生命週期結束為止。

Alpine 支援的版本 可在套件管理員中使用
3.20 8.0、6.0 8.0、6.0
3.19 8.0、6.0 7.0、6.0
3.18 8.0、6.0 7.0、6.0
3.17 8.0、6.0 7.0、6.0

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

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

支援的架構

下表列出目前支援的 .NET 版本及予以支援的 Alpine 架構。 這些版本會持續獲得支援，直到 .NET 版本的支援終止或 Alpine 架構不再受支援為止。 請注意，只有 x86_64、armv7、aarch64 具備 Microsoft 官方支援。 發行版本維護者支援其他架構，而且可以使用 apk 套件管理員安裝。

架構 .NET 6 .NET 8
x86_64 3.16、3.17、3.18、3.19、3.20 3.17、3.18、3.19、3.20
x86 無 無
aarch64 3.16、3.17、3.18、3.19、3.20 3.17、3.18、3.19、3.20
armv7 3.16、3.17、3.18、3.19、3.20 3.17、3.18、3.19、3.20
armhf 無 無
s390x 3.17 3.17
ppc64le 無 無
riscv64 無 無

安裝預覽版本

.NET 的預覽版與候選版均無法在套件存放庫中取得。 您可以使用下列其中一種方式來安裝 .NET 的預覽版與候選版：

移除預覽版本

使用套件管理員來管理 .NET 的安裝時，如果您先前已安裝預覽版，可能會發生衝突。 套件管理員可能會將非預覽版理解為舊版 .NET。 若要安裝非預覽版本，請先解除安裝預覽版本。 如需解除安裝 .NET 的詳細資訊，請參閱如何移除 .NET 執行階段和 SDK (部分機器翻譯)。

相依性

當您使用套件管理員安裝時，系統會為您安裝這些程式庫。 不過，如果您手動安裝 .NET 或發佈獨立式應用程式，則必須確定已安裝這些程式庫：

3.18+

  • ca-certificates-bundle
  • libgcc
  • libssl3
  • libstdc++
  • zlib
  • libgdiplus (如果 .NET 應用程式需要 System.Drawing.Common 組件)

3.15 - 3.17

  • icu-libs
  • krb5-libs
  • libgcc
  • libintl
  • libssl3
  • libstdc++
  • zlib
  • libgdiplus (如果 .NET 應用程式需要 System.Drawing.Common 組件)

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

如果 .NET 應用程式使用 System.Drawing.Common 組件，則也需安裝 libgdiplus。 因為 Linux 上不再支援 System.Drawing.Common，所以這只適用於 .NET 6，而且需要設定 System.Drawing.EnableUnixSupport 執行階段組態參數。

若要安裝 libgdiplus，請執行：

apk add libgdiplus

下一步