Freigeben über


Installieren sie .NET unter Linux mithilfe eines Installationsskripts oder durch Extrahieren von Binärdateien

In diesem Artikel wird veranschaulicht, wie Sie das .NET SDK oder die .NET Runtime unter Linux mithilfe des Installationsskripts oder durch Extrahieren der Binärdateien installieren. Eine Liste der Verteilungen, die den integrierten Paket-Manager unterstützen, finden Sie unter Install .NET unter Linux.

Installieren Sie das SDK (einschließlich der Laufzeit), wenn Sie .NET Apps entwickeln möchten. Wenn Sie Apps nur ausführen möchten, installieren Sie die Runtime. Wenn Sie die Runtime installieren, empfehlen wir, die ASP.NET Core Runtime zu installieren, da sie sowohl .NET als auch ASP.NET Core Laufzeiten enthält.

Überprüfen Sie mithilfe der Befehle und , welche Versionen installiert sind. Weitere Informationen finden Sie unter Wie sie überprüfen, ob .NET bereits installiert ist.

.NET-Veröffentlichungen

Es gibt zwei Arten unterstützter Versionen: Long Term Support (LTS) und Standard Term Support (STS). Die Qualität aller Releases ist gleich. Der einzige Unterschied ist die Dauer der Unterstützung. LTS-Versionen erhalten kostenlosen Support und Patches für drei Jahre. STS-Versionen erhalten kostenlosen Support und Patches für zwei Jahre. Weitere Informationen finden Sie unter .NET Supportrichtlinie.

Die folgende Tabelle enthält den Supportstatus jeder Version von .NET (und .NET Core):

✔️ Unterstützt Nicht unterstützt
10 (LTS) 7
9 (STS) 6
8 (LTS) 5
3.1
3.0
2.2
2.1
2.0
1.1
1,0

Abhängigkeiten

Es ist möglich, dass bei der Installation von .NET bestimmte Abhängigkeiten möglicherweise nicht installiert werden, z. B. wenn Sie manual installieren. In der folgenden Liste sind Linux-Distributionen aufgeführt, die von Microsoft unterstützt werden und Abhängigkeiten aufweisen, die Sie möglicherweise installieren müssen. Weitere Informationen finden Sie auf der Seite zur Distribution:

  • Alpin
  • Debian
  • Fedora
  • RHEL- und CentOS-Stream
  • SLES
  • Ubuntu

Weitere Informationen zu den Abhängigkeiten finden Sie unter Self-contained Linux apps (Eigenständige Linux-Apps).

RPM-Abhängigkeiten

Wenn Ihre Verteilung noch nicht aufgeführt wurde und RPM-basiert ist, benötigen Sie möglicherweise die folgenden Abhängigkeiten:

  • glibc
  • libgcc
  • CA-Zertifikate
  • openssl-libs
  • libstdc++
  • libicu
  • tzdata
  • krb5-libs

DEB-Abhängigkeiten

Wenn Ihre Verteilung noch nicht aufgeführt wurde und debianbasiert ist, benötigen Sie möglicherweise die folgenden Abhängigkeiten:

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

Per Skript gesteuerte Installation

Die dotnet-install-Skripts werden für die Automatisierung sowie für Installationen von SDK und Runtime durch Benutzer ohne Administratorrechte verwendet. Sie können das Skript von https://dot.net/v1/dotnet-install.sh herunterladen. Wenn .NET auf diese Weise installiert wird, müssen Sie die abhängigkeiten installieren, die von Ihrer Linux-Verteilung benötigt werden. Verwenden Sie die Links im Artikel Install .NET unter Linux für Ihre spezifische Linux-Verteilung.

Wichtig

Bash ist für die Ausführung des Skripts erforderlich.

Sie können das Skript mit herunterladen:

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

Oder mit :

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

Bevor Sie dieses Skript ausführen, erteilen Sie unbedingt die Berechtigung, dass dieses Skript als ausführbare Datei ausgeführt werden kann:

chmod +x ./dotnet-install.sh

Das Skript installiert standardmäßig die neueste long Term Support (LTS) SDK-Version, die .NET 10 ist. Verwenden Sie den -Parameter, um das neueste Release zu installieren, bei dem es sich möglicherweise nicht um eine LTS-Version handelt.

./dotnet-install.sh --version latest

Um .NET Runtime anstelle des SDK zu installieren, verwenden Sie den Parameter --runtime.

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

Sie können eine bestimmte Hauptversion mit dem -Parameter installieren, um die bestimmte Version anzugeben. Der folgende Befehl installiert .NET 9.0 SDK.

./dotnet-install.sh --channel 9.0

Weitere Informationen finden Sie in der Referenz zu dotnet-install-Skripts.

Informationen zum Aktivieren von .NET in der Befehlszeile finden Sie unter Set-Umgebungsvariablen systemweit.

Informationen zur Verwendung der .NET CLI finden Sie unter .NET CLI-Übersicht.

Manuelle Installation

Als Alternative zu den Paket-Managern können Sie das SDK und die Runtime herunterladen und manuell installieren. Die manuelle Installation wird in der Regel im Rahmen von Continuous Integration-Tests oder unter nicht unterstützten Linux-Distributionen durchgeführt. Für Entwickler oder Benutzer ist die Verwendung eines Paket-Managers besser geeignet.

Laden Sie eine Binärversion des SDKs oder der Runtime von einer der folgenden Websites herunter. Das .NET SDK enthält die entsprechende Laufzeit:

Extrahieren Sie die heruntergeladene Datei, und verwenden Sie den Befehl export, um DOTNET_ROOT auf den Speicherort des extrahierten Ordners festzulegen, und stellen Sie dann sicher, dass .NET sich in PATH befindet. Beim Exportieren von DOTNET_ROOT werden die .NET CLI-Befehle im Terminal zur Verfügung gestellt. Weitere Informationen zu .NET Umgebungsvariablen finden Sie unter .NET SDK- und CLI-Umgebungsvariablen.

Verschiedene Versionen von .NET können in denselben Ordner extrahiert werden, der nebeneinander vorhanden ist.

Beispiel

Mit den folgenden Befehlen wird Bash verwendet, um die Umgebungsvariable auf das aktuelle Arbeitsverzeichnis gefolgt von festzulegen. Dieses Verzeichnis wird erstellt, wenn es nicht vorhanden ist. Die Umgebungsvariable DOTNET_FILE ist der Dateiname der .NET binären Version, die Sie installieren möchten. Diese Datei wird in das Verzeichnis extrahiert. Sowohl das Verzeichnis als auch das Unterverzeichnis werden der Umgebungsvariablen hinzugefügt.

Wichtig

Wenn Sie diese Befehle ausführen, denken Sie daran, den Wert DOTNET_FILE in den Namen der heruntergeladenen .NET Binärdatei zu ändern.

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

Sie können mehrere Versionen von .NET im selben Ordner installieren.

Sie können auch .NET in das Home-Verzeichnis installieren, das durch die Variable HOME oder den Pfad ~ identifiziert wird.

export DOTNET_ROOT=$HOME/.dotnet

Informationen zur Verwendung der .NET CLI finden Sie unter .NET CLI-Übersicht.

Überprüfen heruntergeladener Binärdateien

Vergewissern Sie sich nach dem Herunterladen eines Installationsprogramms oder Binärrelease, dass die Datei nicht geändert oder beschädigt wurde. Sie können die Prüfsumme auf Ihrem Computer überprüfen und sie dann mit dem auf der Downloadwebsite angegebenen Wert vergleichen.

Wenn Sie die Datei von einer offiziellen Downloadseite herunterladen, wird die Prüfsumme für die Datei in einem Textfeld angezeigt. Wählen Sie die Schaltfläche Kopieren aus, um den Prüfsummenwert in Ihre Zwischenablage zu kopieren.

Die .NET Downloadseite mit Prüfsumme

Verwenden Sie den Befehl , um die Prüfsumme der heruntergeladenen Datei auszugeben. Der folgende Befehl meldet beispielsweise die Prüfsumme der dotnet-sdk-9.0.306-linux-x64.tar.gz Datei:

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

Vergleichen Sie die Prüfsumme mit dem von der Downloadwebsite bereitgestellten Wert.

Verwenden Sie eine Prüfsummendatei zur Verifizierung.

Die .NET Versionshinweise enthalten einen Link zu einer Prüfsummendatei, mit der Sie Ihre heruntergeladene Datei überprüfen können. Die folgenden Schritte beschreiben, wie Sie die Prüfsummendatei herunterladen und eine .NET Installationsdatei validieren:

  1. Die Seite mit den Versionshinweisen für .NET 9 auf GitHub at https://github.com/dotnet/core/tree/main/release-notes/9.0#releases enthält einen Abschnitt mit dem Namen Releases. Die Tabelle in diesem Abschnitt enthält Links zu den Downloads- und Prüfsummendateien für jede .NET 9-Version. Die folgende Abbildung zeigt die .NET 8-Versionstabelle als Referenz:

    Versionstabelle der GitHub-Versionshinweise für .NET

  2. Wählen Sie den Link für die Version von .NET aus, die Sie heruntergeladen haben.

    Im vorherigen Abschnitt wurde .NET SDK 9.0.306 verwendet, das sich in der version .NET 9.0.10 befindet.

  3. Auf der Veröffentlichungsseite können Sie die .NET Runtime- und .NET SDK-Version sowie einen Link zur Prüfsummendatei anzeigen. Die folgende Abbildung zeigt die .NET 8-Versionstabelle als Referenz:

    Die Downloadtabelle mit Prüfsummen für .NET

  4. Klicken Sie mit der rechten Maustaste auf den Checksum-Link und kopieren Sie ihn in die Zwischenablage.

  5. Öffnen Sie ein Terminal.

  6. Verwenden Sie , um die Prüfsummendatei herunterzuladen.

    Ersetzen Sie den Link im folgenden Befehl durch den Link, den Sie kopiert haben.

    curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt
    
  7. Laden Sie sowohl die Prüfsummen- als auch die .NET-Releasedatei in dasselbe Verzeichnis herunter. Verwenden Sie dann den Befehl sha512sum -c {file} --ignore-missing, um die heruntergeladene Datei zu überprüfen.

    Wenn die Überprüfung erfolgreich ist, wird die Datei mit dem Status OK ausgegeben:

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

    Wenn die Datei mit FEHLER markiert ist, ist die heruntergeladene Datei ungültig und sollte nicht verwendet werden.

    $ 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
    

Systemweites Festlegen von Umgebungsvariablen

Wenn Sie das vorherige Installationsskript verwendet haben, gelten die festgelegten Variablen nur für Ihre aktuelle Terminalsitzung. Fügen Sie sie Ihrem Shell-Profil hinzu. Für Linux sind viele verschiedene Shells verfügbar, die jeweils über ein unterschiedliche Profile verfügen. Beispiel:

  • Bash-Shell: ~/.bash_profile oder ~/.bashrc
  • Korn-Shell: ~/.kshrc oder .profile
  • Z-Shell: ~/.zshrc oder .zprofile

Legen Sie die folgenden beiden Umgebungsvariablen in Ihrem Shellprofil fest:

  • DOTNET_ROOT

    Diese Variable wird auf den Ordner festgelegt, auf den .NET installiert wurde, z. B. $HOME/.dotnet:

    export DOTNET_ROOT=$HOME/.dotnet
    
  • PATH

    Diese Variable sollte sowohl den Ordner als auch den Ordner enthalten:

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

Nächste Schritte