Sdílet prostřednictvím

Instalace sady .NET SDK nebo modulu .NET Runtime v Debianu

Tento článek popisuje, jak nainstalovat .NET v Debianu. Pokud verze Debianu přestane být podporována, .NET už tuto verzi nepodporuje. Tyto pokyny vám ale můžou pomoct získat .NET spuštěné v těchto verzích, i když nejsou podporované.

Pokud chcete vyvíjet .NET aplikace, nainstalujte sadu SDK (která zahrnuje modul runtime). Nebo pokud potřebujete spouštět jenom aplikace, nainstalujte modul runtime. Pokud instalujete modul runtime, doporučujeme nainstalovat modul runtime ASP.NET Core, protože zahrnuje moduly runtime .NET i ASP.NET Core.

Pomocí příkazů dotnet --list-sdksdotnet --list-runtimes můžete zjistit, které verze jsou nainstalovány. Další informace najdete v tématu Jak zkontrolovat, zda je .NET již nainstalován.

Podporované distribuce

Následující tabulka obsahuje seznam aktuálně podporovaných verzí .NET a verzí Debianu, na kterých jsou podporované. Tyto verze zůstanou podporované, dokud verze .NET nedosáhne konce podpory nebo verze Debian dosáhne konce životnosti.

Debian .NET
13 10, 9, 8
12 10, 9, 8

Následující verze .NET se už nepodporují ❌:

  • .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

Instalace verzí Preview

Verze Preview a verze Candidate .NET nejsou k dispozici v úložištích balíčků. Preview verze a kandidáty na vydání .NET můžete nainstalovat jedním z následujících způsobů:

Odebrání verzí Preview

Pokud ke správě instalace .NET používáte správce balíčků, může dojít ke konfliktu, pokud jste dříve nainstalovali verzi Preview. Správce balíčků může interpretovat verzi, která není ve verzi Preview, jako starší verzi .NET. Pokud chcete nainstalovat verzi, která není ve verzi Preview, odinstalujte nejprve verze Preview. Další informace o odinstalaci .NET najdete v tématu Jak odebrat .NET Runtime a SDK.

Debian 13

Instalace pomocí APT se dá provést několika příkazy. Před instalací .NET spuštěním následujících příkazů přidejte podpisový klíč balíčku Microsoftu do seznamu důvěryhodných klíčů a přidejte úložiště balíčků.

Otevřete terminál a spusťte následující příkazy:

wget https://packages.microsoft.com/config/debian/13/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Důležité

Informační kanál balíčků Microsoft publikuje pouze balíčky x64 a Arm64 pro .NET 10. Pokud potřebujete nainstalovat .NET do jiných architektur, například Arm32, nepoužívejte správce balíčků s informačním kanálem balíčků Microsoftu. Další informace o instalaci .NET bez správce balíčků najdete v jednom z následujících článků:

Nainstalujte sadu SDK .

Sada .NET SDK umožňuje vyvíjet aplikace pomocí .NET. Pokud nainstalujete sadu .NET SDK, nemusíte instalovat odpovídající modul runtime. Pokud chcete nainstalovat sadu .NET SDK, spusťte následující příkazy:

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

Informace o používání rozhraní příkazového řádku .NET najdete v tématu .NET přehled rozhraní příkazového řádku.

Instalace modulu runtime

Modul ASP.NET Core Runtime umožňuje spouštět aplikace vytvořené pomocí .NET, které neposkytovaly modul runtime. Následující příkazy nainstalují modul ASP.NET Core Runtime, což je nejkomppatibilnější modul runtime pro .NET. V terminálu spusťte následující příkazy:

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

Jako alternativu k modulu ASP.NET Core Runtime můžete nainstalovat modul .NET Runtime, který nezahrnuje podporu ASP.NET Core: nahraďte aspnetcore-runtime-10.0 v předchozím příkazu dotnet-runtime-10.0:

sudo apt-get install -y dotnet-runtime-10.0

Informace o používání rozhraní příkazového řádku .NET najdete v tématu .NET přehled rozhraní příkazového řádku.

Debian 12

Instalace pomocí APT se dá provést několika příkazy. Před instalací .NET spuštěním následujících příkazů přidejte podpisový klíč balíčku Microsoftu do seznamu důvěryhodných klíčů a přidejte úložiště balíčků.

Otevřete terminál a spusťte následující příkazy:

wget https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Důležité

Informační kanál balíčků Microsoft publikuje pouze balíčky x64 a Arm64 pro .NET 10. Pokud potřebujete nainstalovat .NET do jiných architektur, například Arm32, nepoužívejte správce balíčků s informačním kanálem balíčků Microsoftu. Další informace o instalaci .NET bez správce balíčků najdete v jednom z následujících článků.

Nainstalujte sadu SDK .

Sada .NET SDK umožňuje vyvíjet aplikace pomocí .NET. Pokud nainstalujete sadu .NET SDK, nemusíte instalovat odpovídající modul runtime. Pokud chcete nainstalovat sadu .NET SDK, spusťte následující příkazy:

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

Informace o používání rozhraní příkazového řádku .NET najdete v tématu .NET přehled rozhraní příkazového řádku.

Instalace modulu runtime

Modul ASP.NET Core Runtime umožňuje spouštět aplikace vytvořené pomocí .NET, které neposkytovaly modul runtime. Následující příkazy nainstalují modul ASP.NET Core Runtime, což je nejkomppatibilnější modul runtime pro .NET. V terminálu spusťte následující příkazy:

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

Jako alternativu k modulu ASP.NET Core Runtime můžete nainstalovat modul .NET Runtime, který nezahrnuje podporu ASP.NET Core: nahraďte aspnetcore-runtime-10.0 v předchozím příkazu dotnet-runtime-10.0:

sudo apt-get install -y dotnet-runtime-10.0

Informace o používání rozhraní příkazového řádku .NET najdete v tématu .NET přehled rozhraní příkazového řádku.

Aktualizace .NET pomocí APT

Pokud je pro .NET k dispozici nová verze opravy, můžete ji upgradovat pomocí apt pomocí následujících příkazů:

sudo apt-get update
sudo apt-get upgrade

Pokud jste upgradovali distribuci Linuxu od instalace .NET, možná budete muset překonfigurovat úložiště balíčků Microsoftu. Spusťte pokyny k instalaci pro vaši aktuální distribuční verzi, abyste upgradovali na příslušné úložiště balíčků pro aktualizace .NET.

Řešení problému

Tato část poskytuje informace o běžných chybách, které mohou nastat při použití APT pro instalaci .NET.

Nepodařilo se najít balíček

Důležité

Informační kanál balíčků Microsoft publikuje balíčky pro různé architektury v závislosti na verzi .NET:

  • .NET 10: pouze balíčky x64 a Arm64.
  • .NET 9: pouze balíčky x64.
  • .NET 8: pouze balíčky x64.

Pokud potřebujete nainstalovat .NET do jiných architektur, například Arm32, nepoužívejte správce balíčků s informačním kanálem balíčků Microsoftu. Další informace o instalaci .NET bez správce balíčků najdete v jednom z následujících článků.

Nelze najít \ Některé balíčky nelze nainstalovat.

Pokud se zobrazí chybová zpráva podobná tomu, že nelze najít balíček {dotnet-package} nebo některé balíčky nelze nainstalovat, spusťte následující příkazy.

Následující sada příkazů obsahuje dva zástupné symboly.

  • {dotnet-package}
    Představuje balíček .NET, který instalujete, například aspnetcore-runtime-8.0. Používá se v následujícím sudo apt-get install příkazu.

Nejprve zkuste seznam balíčků vyprázdnit:

sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update

Potom zkuste nainstalovat .NET znovu. Pokud to nepomůže, můžete ruční instalaci spustit pomocí následujících příkazů:

Pokud používáte Debian 12 nebo novější, zkuste následující příkazy:

# Get OS version info which adds the $ID and $VERSION_ID variables
source /etc/os-release

# Download the Microsoft keys
sudo apt-get install -y gpg wget
wget https://packages.microsoft.com/keys/microsoft.asc
cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg

# Add the Microsoft repository to the system's sources list
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list

# Move the key to the appropriate place
sudo mv microsoft.asc.gpg $(cat /etc/apt/sources.list.d/microsoft-prod.list | grep -oP "(?<=signed-by=).*(?=\])")

# Update packages and install .NET
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Pokud používáte debianovou verzi starší než 12, zkuste následující příkazy:

# Define the OS version, name, and codename
source /etc/os-release

# Download the Microsoft keys
sudo apt-get install -y gpg wget
wget https://packages.microsoft.com/keys/microsoft.asc
cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/

# Add the Microsoft repository to the system's sources list
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list

# Set ownership
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list

# Update packages and install .NET
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Načtení se nezdařilo.

Při instalaci balíčku .NET se může zobrazit chyba podobná Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Tato chyba může znamenat, že se zdroj balíčků pro .NET aktualizuje na novější verze balíčků a že byste to měli zkusit znovu později. Během upgradu by zásobník balíčku neměl být nedostupný po dobu delší než 30 minut. Pokud se tato chyba nepřetržitě zobrazuje déle než 30 minut, zapište problém na adrese https://github.com/dotnet/core/issues.

Závislosti

Při instalaci pomocí správce balíčků se tyto knihovny nainstalují za vás. Pokud ale ručně nainstalujete .NET nebo publikujete samostatnou aplikaci, budete se muset ujistit, že jsou tyto knihovny nainstalované:

13.x

  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu72
  • libssl3
  • libstdc++6
  • zlib1g

12.x

  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu72
  • libssl3
  • libstdc++6
  • zlib1g

Další poznámky

Závislosti lze nainstalovat pomocí příkazu apt install. Následující fragment kódu ukazuje instalaci libc6 knihovny:

sudo apt install libc6

Další kroky

  • Last updated on