Udostępnij za pośrednictwem

Instalowanie .NET w systemie Linux przy użyciu skryptu instalacji lub wyodrębniania plików binarnych

W tym artykule pokazano, jak zainstalować zestaw SDK .NET lub środowisko uruchomieniowe .NET w systemie Linux przy użyciu skryptu instalacji lub wyodrębniając pliki binarne. Aby uzyskać listę dystrybucji, które obsługują wbudowanego menedżera pakietów, zobacz Install .NET w systemie Linux.

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.

wydania .NET

Istnieją dwa typy obsługiwanych wersji: obsługa długoterminowa (LTS) i obsługa standardowa (STS). Jakość wszystkich wydań jest taka sama. Jedyną różnicą jest długość wsparcia. Wersje LTS otrzymują bezpłatną pomoc techniczną i poprawki przez trzy lata. Wersje STS otrzymują bezpłatną pomoc techniczną i poprawki przez dwa lata. Aby uzyskać więcej informacji, zobacz .NET Zasady pomocy technicznej.

W poniższej tabeli wymieniono stan obsługi każdej wersji .NET (i .NET Core):

✔️ Obsługiwane ❌ Brak pomocy technicznej
10 (LTS) 7
9 (STS) 6
8 (LTS) 5
3.1
3.0
2,2
2.1
2.0
1.1
1.0

Zależności

Istnieje możliwość, że podczas instalacji .NET pewne zależności nie zostaną zainstalowane, na przykład gdy instalujesz ręcznie. Poniższa lista zawiera szczegółowe informacje na temat dystrybucji systemu Linux obsługiwanych przez firmę Microsoft i zależności, które mogą być konieczne do zainstalowania. Aby uzyskać więcej informacji, sprawdź stronę dystrybucji:

Aby uzyskać ogólne informacje o zależnościach, zobacz Samodzielne aplikacje systemu Linux.

Zależności RPM

Jeśli dystrybucja nie została wcześniej wymieniona i jest oparta na obr./min, mogą być potrzebne następujące zależności:

  • glibc
  • libgcc
  • certyfikaty ca
  • openssl-libs
  • libstdc++
  • libicu
  • tzdata
  • krb5-libs

Zależności DEB

Jeśli dystrybucja nie została wcześniej wymieniona i jest oparta na debianie, może być konieczne następujące zależności:

  • libc6
  • libgcc1
  • libgssapi-krb5-2
  • libicu70
  • libssl3
  • libstdc++6
  • zlib1g

Instalacja skryptowa

Skrypty dotnet-install są używane do automatyzacji i instalacji bez uprawnień administracyjnych pakietu SDK i środowiska wykonawczego. Skrypt można pobrać z https://dot.net/v1/dotnet-install.sh. Po zainstalowaniu .NET w ten sposób należy zainstalować zależności wymagane przez dystrybucję systemu Linux. Skorzystaj z linków w artykule Install .NET w systemie Linux dla określonej dystrybucji systemu Linux.

Ważne

Do uruchomienia skryptu wymagany jest Bash.

Skrypt można pobrać za pomocą polecenia wget:

wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh

Lub za pomocą polecenia curl:

curl -L https://dot.net/v1/dotnet-install.sh -o dotnet-install.sh

Przed uruchomieniem tego skryptu upewnij się, że udzielono uprawnień do uruchamiania tego skryptu jako pliku wykonywalnego:

chmod +x ./dotnet-install.sh

Skrypt domyślnie instaluje najnowszą wersję zestawu SDK long term support (LTS), który to .NET 10. Aby zainstalować najnowszą wersję, która może nie być wersją (LTS), użyj parametru --version latest .

./dotnet-install.sh --version latest

Aby zainstalować środowisko .NET Runtime zamiast zestawu SDK, użyj parametru --runtime.

./dotnet-install.sh --version latest --runtime aspnetcore

Możesz zainstalować określoną wersję główną z parametrem , --channel aby wskazać określoną wersję. Następujące polecenie instaluje zestaw SDK .NET 9.0.

./dotnet-install.sh --channel 9.0

Aby uzyskać więcej informacji, zobacz dotnet-install scripts reference (Dokumentacja skryptów dotnet-install).

Aby włączyć .NET w wierszu polecenia, zobacz Set zmiennych środowiskowych dla całego systemu.

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

Instalacja ręczna

Alternatywą dla menedżerów pakietów jest pobranie i ręczne zainstalowanie zestawu SDK i środowiska uruchomieniowego. Instalacja ręczna jest często używana w ramach ciągłego testowania integracji lub w nieobsługiwanej dystrybucji systemu Linux. W przypadku dewelopera lub użytkownika lepiej użyć menedżera pakietów.

Pobierz wersję binarną dla zestawu SDK lub środowiska uruchomieniowego z jednej z następujących witryn. Zestaw SDK .NET zawiera odpowiednie środowisko uruchomieniowe:

Wyodrębnij pobrany plik i użyj polecenia export, aby ustawić DOTNET_ROOT do lokalizacji wyodrębnionego folderu, a następnie upewnij się, że .NET znajduje się w ścieżce. Wyeksportowanie DOTNET_ROOT sprawia, że polecenia .NET CLI stają się dostępne w terminalu. Aby uzyskać więcej informacji na temat zmiennych środowiskowych .NET, zobacz .NET zestaw SDK i zmienne środowiskowe interfejsu wiersza polecenia.

Różne wersje .NET można wyodrębnić do tego samego folderu, który współistnieje obok siebie.

Przykład

Następujące polecenia używają powłoki Bash, aby ustawić zmienną środowiskową DOTNET_ROOT na bieżący katalog roboczy, a następnie ustawić ją na .dotnet. Ten katalog jest tworzony, jeśli nie istnieje. Zmienna środowiskowa DOTNET_FILE jest nazwą pliku .NET wersji binarnej, którą chcesz zainstalować. Ten plik jest wyodrębniany do DOTNET_ROOT katalogu. Zarówno katalog DOTNET_ROOT jak i jego podkatalog tools są dodawane do zmiennej środowiskowej PATH.

Ważne

Jeśli uruchomisz te polecenia, pamiętaj, aby zmienić wartość DOTNET_FILE na nazwę pobranego pliku binarnego .NET.

DOTNET_FILE=dotnet-sdk-9.0.306-linux-x64.tar.gz
export DOTNET_ROOT=$(pwd)/.dotnet

mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"

export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools

W tym samym folderze można zainstalować więcej niż jedną wersję .NET.

Można również zainstalować .NET do katalogu zidentyfikowanego przez zmienną HOME lub ścieżkę ~:

export DOTNET_ROOT=$HOME/.dotnet

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

Weryfikowanie pobranych plików binarnych

Po pobraniu instalatora lub wydania binarnego sprawdź, czy plik nie został zmieniony ani uszkodzony. Możesz sprawdzić sumę kontrolną na swoim komputerze, a następnie porównać ją z tym, co zostało podane na stronie pobierania.

Po pobraniu pliku z oficjalnej strony pobierania suma kontrolna pliku jest wyświetlana w polu tekstowym. Wybierz przycisk Kopiuj, aby skopiować wartość sumy kontrolnej do schowka.

Strona pobierania .NET ze sumą kontrolną

sha512sum Użyj polecenia , aby wyświetlić sumę kontrolną pobranego pliku. Na przykład następujące polecenie zgłasza sumę kontrolną pliku dotnet-sdk-9.0.306-linux-x64.tar.gz :

$ sha512sum dotnet-sdk-9.0.306-linux-x64.tar.gz
bbb6bdc3c8048e7cc189759b406257839e7d4bd6b8b1ba4bcdaeea8f92340e6855231043dd73f902130ca5357af72b810bb51a4da4d1315a2927ff85f831f1d5  dotnet-sdk-9.0.306-linux-x64.tar.gz

Porównaj sumę kontrolną z wartością podaną przez witrynę pobierania.

Użyj pliku sumy kontrolnej do sprawdzenia poprawności

Informacje o wersji .NET zawierają link do pliku sumy kontrolnej, którego można użyć do zweryfikowania pobranego pliku. W poniższych krokach opisano sposób pobierania pliku sumy kontrolnej i weryfikowania instalacyjnego pliku binarnego .NET:

  1. Strona informacji o wersji dla .NET 9 w GitHub o https://github.com/dotnet/core/tree/main/release-notes/9.0#releases zawiera sekcję o nazwie Releases. Tabela w tej sekcji zawiera linki do plików do pobrania i sum kontrolnych dla każdej wersji .NET 9. Na poniższej ilustracji przedstawiono tabelę wersji .NET 8 jako odniesienie.

    Tabela notatek o wersji GitHub dla .NET

  2. Wybierz link dla pobranej wersji .NET.

    W poprzedniej sekcji użyto zestawu .NET SDK 9.0.306, który znajduje się w wersji .NET 9.0.10.

  3. Na stronie wydania można zobaczyć wersję .NET Runtime, .NET SDK oraz link do pliku sum kontrolnych. Na poniższej ilustracji przedstawiono tabelę wersji .NET 8 jako odniesienie.

    Pobierzesz tabelę z sumami kontrolnymi dla .NET

  4. Kliknij prawym przyciskiem myszy link Suma kontrolna i skopiuj go do schowka.

  5. Otwórz terminal.

  6. Użyj curl -O {link} aby pobrać plik sumy kontrolnej.

    Zastąp link w poniższym poleceniu skopiowanym linkiem.

    curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt

  7. W przypadku zarówno pliku sumy kontrolnej, jak i pliku wydania .NET pobranego do tego samego katalogu, użyj polecenia sha512sum -c {file} --ignore-missing, aby zweryfikować pobrany plik.

    Po pomyślnym zakończeniu walidacji zostanie wyświetlony plik wydrukowany ze stanem OK :

    $ sha512sum -c 9.0.10-sha.txt --ignore-missing
dotnet-sdk-9.0.306-linux-x64.tar.gz: OK

    Jeśli zobaczysz plik oznaczony jako NIEPOWODZENIE, pobrany plik nie jest prawidłowy i nie powinien być używany.

    $ sha512sum -c 9.0.10-sha.txt --ignore-missing
dotnet-sdk-9.0.306-linux-x64.tar.gz: FAILED
sha512sum: WARNING: 1 computed checksum did NOT match
sha512sum: 9.0.10-sha.txt: no file was verified

Ustawianie zmiennych środowiskowych dla całego systemu

Jeśli użyto poprzedniego skryptu instalacji, zmienne ustawione dotyczą tylko bieżącej sesji terminalu. Dodaj je do profilu shella. Istnieje wiele różnych powłok dostępnych dla systemu Linux i każda z nich ma inny profil. Przykład:

  • Powłoka Bash: ~/.bash_profile lub ~/.bashrc
  • Korn Shell: ~/.kshrc lub .profile
  • Zsh: ~/.zshrc lub .zprofile

Ustaw następujące dwie zmienne środowiskowe w profilu powłoki:

  • DOTNET_ROOT

    Ta zmienna jest ustawiona na folder, do którego zainstalowano .NET, na przykład $HOME/.dotnet:

    export DOTNET_ROOT=$HOME/.dotnet

  • PATH

    Ta zmienna powinna zawierać zarówno folder DOTNET_ROOT jak i folder DOTNET_ROOT/tools.

    export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools

Dalsze kroki

  • Last updated on