Udostępnij za pośrednictwem

Instalowanie zestawu .NET SDK lub środowiska uruchomieniowego .NET w systemie Debian

W tym artykule opisano sposób instalowania .NET w systemie Debian. Gdy wersja Debian nie jest obsługiwana, .NET nie jest już obsługiwana w tej wersji. Jednak te instrukcje mogą pomóc w uruchomieniu .NET na tych wersjach, mimo że nie są obsługiwane.

Zainstaluj zestaw SDK (obejmujący środowisko uruchomieniowe), jeśli chcesz opracowywać aplikacje .NET. Lub, jeśli potrzebujesz tylko uruchamiać aplikacje, zainstaluj środowisko uruchomieniowe. Jeśli instalujesz środowisko uruchomieniowe, sugerujemy zainstalowanie środowiska uruchomieniowego ASP.NET Core runtime ponieważ obejmuje zarówno środowiska uruchomieniowe .NET, jak i ASP.NET Core.

Użyj poleceń dotnet --list-sdks i dotnet --list-runtimes, aby zobaczyć, które wersje są zainstalowane. Aby uzyskać więcej informacji, zobacz Jak sprawdzić, czy .NET jest już zainstalowany.

Obsługiwane dystrybucje

Poniższa tabela zawiera listę aktualnie obsługiwanych wersji .NET i obsługiwanych wersji debiana. Te wersje pozostają obsługiwane, dopóki wersja .NET nie osiągnie końca wsparcia lub wersji Debian osiągnie koniec życia.

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

Następujące wersje .NET nie są już obsługiwane ❌:

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

Instalowanie wersji zapoznawczych

Wersje zapoznawcze i kandydaci do wydania .NET nie są dostępne w repozytoriach pakietów. Możesz zainstalować wersje zapoznawcze i kandydatów do wydania .NET w jeden z następujących sposobów:

Usuwanie wersji zapoznawczych

W przypadku zarządzania instalacją .NET za pomocą menedżera pakietów może wystąpić konflikt, jeśli wcześniej zainstalowano wersję zapoznawcza. Menedżer pakietów może interpretować wydanie inne niż wersja zapoznawcza jako wcześniejszą wersję .NET. Aby zainstalować wersję inną niż wersja zapoznawcza, najpierw odinstaluj wersje zapoznawcza. Aby uzyskać więcej informacji na temat odinstalowywania .NET, zobacz Jak usunąć środowisko uruchomieniowe .NET i zestaw SDK.

Debian 13

Instalowanie za pomocą narzędzia APT można wykonać za pomocą kilku poleceń. Przed zainstalowaniem .NET uruchom następujące polecenia, aby dodać klucz podpisywania pakietów firmy Microsoft do listy zaufanych kluczy i dodać repozytorium pakietów.

Otwórz terminal i uruchom następujące polecenia:

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

Ważne

Źródło pakietów Microsoft publikuje tylko x64 i Arm64 pakiety dla .NET 10. Jeśli musisz zainstalować .NET na innych architekturach, takich jak Arm32, nie używaj menedżera pakietów z repozytorium pakietów Microsoft. Aby uzyskać więcej informacji na temat instalowania .NET without a package manager, zobacz jeden z następujących artykułów:

Instalacja zestawu SDK

Zestaw SDK .NET umożliwia tworzenie aplikacji za pomocą .NET. Jeśli zainstalujesz zestaw SDK .NET, nie musisz instalować odpowiedniego środowiska uruchomieniowego. Aby zainstalować zestaw SDK .NET, uruchom następujące polecenia:

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

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia .NET, zobacz .NET omówienie interfejsu wiersza polecenia.

Instalowanie środowiska uruchomieniowego

Środowisko uruchomieniowe ASP.NET Core umożliwia uruchamianie aplikacji wykonanych z .NET, które nie udostępniały środowiska uruchomieniowego. Następujące polecenia instalują środowisko uruchomieniowe ASP.NET Core, które jest najbardziej zgodnym środowiskiem uruchomieniowym dla .NET. W terminalu uruchom następujące polecenia:

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

Alternatywą dla środowiska uruchomieniowego ASP.NET Core jest zainstalowanie środowiska uruchomieniowego .NET, które nie obejmuje obsługi ASP.NET Core: zastąp aspnetcore-runtime-10.0 w poprzednim poleceniu dotnet-runtime-10.0:

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

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia .NET, zobacz .NET omówienie interfejsu wiersza polecenia.

Debian 12

Instalowanie za pomocą narzędzia APT można wykonać za pomocą kilku poleceń. Przed zainstalowaniem .NET uruchom następujące polecenia, aby dodać klucz podpisywania pakietów firmy Microsoft do listy zaufanych kluczy i dodać repozytorium pakietów.

Otwórz terminal i uruchom następujące polecenia:

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

Ważne

Źródło pakietów Microsoft publikuje tylko x64 i Arm64 pakiety dla .NET 10. Jeśli musisz zainstalować .NET na innych architekturach, takich jak Arm32, nie używaj menedżera pakietów z repozytorium pakietów Microsoft. Aby uzyskać więcej informacji na temat instalowania .NET without a package manager, zobacz jeden z następujących artykułów:

Instalacja zestawu SDK

Zestaw SDK .NET umożliwia tworzenie aplikacji za pomocą .NET. Jeśli zainstalujesz zestaw SDK .NET, nie musisz instalować odpowiedniego środowiska uruchomieniowego. Aby zainstalować zestaw SDK .NET, uruchom następujące polecenia:

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

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia .NET, zobacz .NET omówienie interfejsu wiersza polecenia.

Instalowanie środowiska uruchomieniowego

Środowisko uruchomieniowe ASP.NET Core umożliwia uruchamianie aplikacji wykonanych z .NET, które nie udostępniały środowiska uruchomieniowego. Następujące polecenia instalują środowisko uruchomieniowe ASP.NET Core, które jest najbardziej zgodnym środowiskiem uruchomieniowym dla .NET. W terminalu uruchom następujące polecenia:

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

Alternatywą dla środowiska uruchomieniowego ASP.NET Core jest zainstalowanie środowiska uruchomieniowego .NET, które nie obejmuje obsługi ASP.NET Core: zastąp aspnetcore-runtime-10.0 w poprzednim poleceniu dotnet-runtime-10.0:

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

Aby dowiedzieć się, jak używać interfejsu wiersza polecenia .NET, zobacz .NET omówienie interfejsu wiersza polecenia.

Aktualizowanie .NET przy użyciu narzędzia APT

Gdy dla .NET jest dostępna nowa wersja poprawki, można uaktualnić ją za pomocą narzędzia APT za pomocą następujących poleceń:

sudo apt-get update
sudo apt-get upgrade

W przypadku uaktualnienia dystrybucji systemu Linux od momentu zainstalowania .NET może być konieczne ponowne skonfigurowanie repozytorium pakietów firmy Microsoft. Uruchom instrukcje dotyczącą instalacji dla bieżącej wersji dystrybucji, aby zaktualizować odpowiedni pakiet repozytoriów na potrzeby aktualizacji .NET.

Rozwiązywanie problemów

Ta sekcja zawiera informacje na temat typowych błędów, które mogą wystąpić podczas instalowania .NET przy użyciu narzędzia APT.

Nie można odnaleźć pakietu

Ważne

Źródło pakietów Microsoft publikuje pakiety dla różnych architektur w zależności od wersji .NET:

  • .NET 10: tylko x64 i Arm64 pakiety.
  • .NET 9: tylko x64 pakiety.
  • .NET 8: tylko pakiety x64.

Jeśli musisz zainstalować .NET na innych architekturach, takich jak Arm32, nie używaj menedżera pakietów z repozytorium pakietów Microsoft. Aby uzyskać więcej informacji na temat instalowania .NET without a package manager, zobacz jeden z następujących artykułów:

Nie można zlokalizować \ Nie można zainstalować niektórych pakietów

Jeśli zostanie wyświetlony komunikat o błędzie podobny do Nie można zlokalizować pakietu {dotnet-package} lub nie można zainstalować niektórych pakietów, uruchom następujące polecenia.

W poniższym zestawie poleceń znajdują się dwa symbole zastępcze.

  • {dotnet-package}
    Reprezentuje instalowany pakiet .NET, taki jak aspnetcore-runtime-8.0. Jest to używane w poniższym sudo apt-get install poleceniu.

Najpierw spróbuj przeczyścić listę pakietów:

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

Następnie spróbuj ponownie zainstalować .NET. Jeśli to nie zadziała, możesz uruchomić ręczną instalację przy użyciu następujących poleceń:

Jeśli używasz systemu Debian 12 lub nowszego, spróbuj wykonać następujące polecenia:

# 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}

Jeśli używasz wersji Debian starszej niż 12, spróbuj wykonać następujące polecenia:

# 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}

Nie można pobrać

Podczas instalowania pakietu .NET może zostać wyświetlony błąd podobny do Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Ten błąd może oznaczać, że kanał informacyjny pakietu dla .NET jest uaktualniany przy użyciu nowszych wersji pakietów i należy spróbować ponownie później. Podczas uaktualniania należy unikać sytuacji, w której repozytorium pakietów byłoby niedostępne przez ponad 30 minut. Jeśli ten błąd jest stale wyświetlany przez ponad 30 minut, zgłoś problem pod adresem https://github.com/dotnet/core/issues.

Zależności

Podczas instalowania za pomocą menedżera pakietów te biblioteki są instalowane automatycznie. Jeśli jednak ręcznie zainstalujesz .NET lub opublikujesz samodzielną aplikację, musisz upewnić się, że te biblioteki są zainstalowane:

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

Inne notatki

Zależności można zainstalować za pomocą polecenia apt install. Poniższy fragment kodu przedstawia instalowanie libc6 biblioteki:

sudo apt install libc6

Następne kroki

  • Last updated on