Installationsanleitung für .NET unter Ubuntu - Entscheidungshilfe

Dieser Artikel hilft Ihnen bei der Entscheidung, wie .NET auf Ubuntu installiert werden soll. Ab Ubuntu 22.04 sind die meisten unterstützten Versionen von .NET im integrierten Ubuntu-Feed verfügbar. Das Repository für Ubuntu .NET Backports-Paket enthält die verbleibenden unterstützten .NET Versionen.

Canonical hat die Veröffentlichung .NET auf Ubuntu übernommen. Ab Ubuntu 22.04 verteilt Microsoft nicht mehr .NET für Ubuntu an das Microsoft-Paket-Repository.

Unterstützte Distributionen

Die folgende Tabelle ist eine Liste der derzeit unterstützten .NET Versionen und der Versionen von Ubuntu, auf die sie unterstützt werden. Jeder Link wird zur spezifischen Ubuntu-Versionsseite mit Anweisungen zum Installieren von .NET für diese Version von Ubuntu.

Wenn eine Ubuntu-Version das Ende des Supportzeitraums erreicht, wird .NET mit dieser bestimmten Ubuntu-Version nicht mehr unterstützt.

Kanonisch unterstützt .NET Versionen im integrierten Ubuntu-Feed für die Lebensdauer dieser Ubuntu-Version, auch außerhalb der von Microsoft bereitgestellten Supportlebensdauer und bietet Best-Effort-Unterstützung für .NET Versionen im .NET Backports-Paket-Repository, das nicht über die von Microsoft bereitgestellte Supportlebensdauer hinausgeht.

Die folgenden Versionen von .NET werden ❌ nicht mehr unterstützt:

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

Überlegungen beim Upgrade von Ubuntu

Upgrade von Ubuntu auf 22.04 oder höher? Erwägen Sie zuerst, .NET zu deinstallieren.

Wenn Sie einen Paket-Manager verwendet haben, um .NET aus dem Microsoft-Paket-Repository zu installieren, können Sie nach dem Upgrade von Ubuntu mit einer Paket-Verwechslung konfrontiert werden. Da Canonical nun .NET in den Paketfeeds für Ubuntu 22.04 (und höhere Versionen) veröffentlicht, weiß der Paket-Manager nicht mehr über die zuvor installierte .NET Version. Die Pakete können nicht auf das aktuellste .NET-Framework aktualisiert werden. Deinstallieren Sie sie zuerst, und installieren Sie sie dann aus dem Ubuntu-Paket-Repository erneut.

Entscheiden, wie .NET installiert werden soll

Wenn Ihre Version von Ubuntu .NET über den integrierten oder .NET Backports Ubuntu-Feed unterstützt, wird die Unterstützung für diese Builds von .NET von Canonical bereitgestellt, und die Builds können für verschiedene Workloads optimiert werden. Microsoft bietet Unterstützung für Pakete im Microsoft-Paket-Repositoryfeed.

Verwenden Sie die folgenden Abschnitte, um zu bestimmen, wie Sie .NET installieren sollten:

• I verwende Ubuntu 22.04 oder höher, und ich benötige nur .NET
• Ich verwende eine Version von Ubuntu vor 22.04
• Ich verwende andere Microsoft-Pakete, wie powershell, mdatp oder mssql
• I möchten eine .NET App erstellen
• Ich möchte eine .NET-App in einem Container, in der Cloud oder in einem Continuous-Integration-Szenario ausführen
• Meine Ubuntu-Distribution enthält nicht die gewünschte .NET-Version, oder ich benötige eine nicht unterstützte .NET-Version
• Ich möchte eine Vorschauversion installieren
• Ich möchte APT nicht verwenden
• Ich verwende eine ARM-basierte CPU
• Ich verwende die IBM System Z- oder Power-Plattform

Ich verwende Ubuntu 22.04 oder höher, und ich benötige nur .NET

Wenn Sie keine anderen Microsoft-Pakete wie powershell, mdatp oder mssql benötigen, installieren Sie .NET über den Ubuntu-Feed. Weitere Informationen finden Sie auf den folgenden Seiten:

• Install .NET auf Ubuntu 25.10.
• Install .NET auf Ubuntu 25.04.
• Install .NET auf Ubuntu 24.04.
• Install .NET auf Ubuntu 22.04.

Wenn Sie das Microsoft-Repository installieren möchten, um andere Microsoft-Pakete zu verwenden, z. B. powershell, mdatp oder mssql, müssen Sie die vom Microsoft-Repository bereitgestellten .NET Pakete entprioritisieren. Anweisungen zum Entprioritisieren der Pakete finden Sie unter My Linux distribution stellt .NET Pakete bereit, und ich möchte sie verwenden.

Ich verwende eine Version von Ubuntu vor 22.04

Verwenden Sie die Anweisungen im versionsspezifischen Abschnitt von Install .NET SDK oder .NET Runtime auf Ubuntu.

Lesen Sie den Abschnitt Supported distributions, um weitere Informationen darüber zu erhalten, welche Versionen von .NET für Ihre Ubuntu-Version unterstützt werden. Wenn Sie eine nicht unterstützte Version installieren, lesen Sie Registrierung des Microsoft-Paket-Repositorys.

Ich verwende andere Microsoft-Programme, wie powershell, mdatp oder z. B. mssql.

Wenn Ihre Ubuntu-Version .NET über ein Ubuntu-Feeds unterstützt, müssen Sie entscheiden, welcher Feed .NET installieren soll. Der Abschnitt Supported distributions enthält eine Tabelle, in der aufgelistet wird, welche Versionen von .NET in den Paketfeeds verfügbar sind.

Wenn Sie die .NET Pakete aus einem Ubuntu-Feed beziehen möchten, müssen Sie die vom Microsoft-Repository bereitgestellten .NET Pakete entprioritisieren. Anweisungen zum Entprioritisieren der Pakete finden Sie unter My Linux distribution stellt .NET Pakete bereit, und ich möchte sie verwenden.

Ich möchte eine .NET-App erstellen

Verwenden Sie die gleichen Paketquellen für das SDK wie für die Laufzeit. Es wird empfohlen, .NET über einen Ubuntu-Feed zu installieren. Wenn Sie jedoch .NET aus einer anderen Quelle installieren möchten (z. B. das Microsoft-Paket-Repository für den Zugriff auf höhere SDK-Featurebänder), sollten Sie .NET deinstallieren, konfigurieren Sie ihren Paket-Manager so, dass .NET Pakete aus dem Ubuntu-Feed ignoriert und aus der anderen Quelle neu installiert werden.

Überprüfen Sie die anderen Vorschläge im Abschnitt Decide, wie sie .NET installieren.

Ich möchte eine .NET-App in einem Container-, Cloud- oder Fortlaufendintegrationsszenario ausführen.

Wenn Ihre Ubuntu-Version die .NET Version bereitstellt, die Sie benötigen, installieren Sie sie aus einem Ubuntu-Feed. Andernfalls registern Sie das Microsoft-Paket-Repository und installieren Sie .NET aus diesem Repository. Überprüfen Sie die Informationen im Abschnitt "Unterstützte Verteilungen ".

Wenn die gewünschte Version von .NET nicht verfügbar ist, versuchen Sie, das Skript dotnet-install zu verwenden.

Meine Ubuntu-Distribution enthält nicht die .NET-Version, die ich möchte, oder ich benötige eine nicht mehr unterstützte .NET-Version.

Es wird empfohlen, APT und das Microsoft-Paket-Repository zu verwenden. Weitere Informationen finden Sie im Abschnitt "Registrieren und Installieren mit dem Microsoft-Paketrepository ".

Ich möchte eine Vorschauversion installieren

Verwenden Sie eine der folgenden Möglichkeiten zum Installieren von .NET:

• Install .NET mit install-dotnet script.
• Manually install .NET

Ich möchte APT nicht verwenden

Wenn Sie eine automatisierte Installation benötigen, verwenden Sie das Linux-Installationsskript.

Wenn Sie die vollständige Kontrolle über die .NET Installationserfahrung wünschen, laden Sie einen Tarball herunter, und installieren Sie .NET manuell. Weitere Informationen finden Sie unter Manuelle Installation.

Ich verwende eine ARM-basierte CPU

Wenn Ihre Ubuntu-Version die .NET Version bereitstellt, die Sie benötigen, installieren Sie sie aus dem integrierten Feed. Überprüfen Sie die Informationen im Abschnitt "Unterstützte Verteilungen ".

Wenn die gewünschte Version von .NET nicht verfügbar ist, versuchen Sie, eine der folgenden Möglichkeiten zum Installieren von .NET zu verwenden:

• Install .NET mit install-dotnet script.
• Manually install .NET

Ich verwende die IBM System Z- oder Power-Plattform

Ab .NET 8 auf Ubuntu 22.04 unterstützt Canonical .NET für die IBM System Z- und Power-Plattformen. Diese Unterstützung wird für jede .NET-Version in Zukunft fortgesetzt.

Installieren Sie .NET über den integrierten Ubuntu-Feed. Weitere Informationen finden Sie auf der folgenden Seite:

• Install .NET 10 auf Ubuntu 25.10.

Registrieren eines Paket-Repositorys

Je nach Ihrer Version von Ubuntu müssen Sie möglicherweise entweder die Ubuntu-Backports oder das Microsoft-Paket-Repository registrieren.

• Registern Sie das Ubuntu .NET Backports-Paket-Repository
• Registrieren des Microsoft-Paket-Repositorys

Ubuntu .NET Backports-Paket-Repository

Das Ubuntu .NET Backports-Paket-Repository stellt Versionen von .NET bereit, die nicht im integrierten Ubuntu-Feed verfügbar sind. Kanonisch verwaltet die Pakete, die in diesem Paket-Repository enthalten sind, und bietet Best-Effort-Unterstützung, die sich nicht über die von Microsoft bereitgestellte Supportlebensdauer oder den Supportzeitraum der jeweiligen Ubuntu-Version erstreckt.

Dieses Paketrepository wird unter Ubuntu 24.04 LTS (Noble Numbat) und Ubuntu 22.04 LTS (Jammy Jellyfish) unterstützt. Der Abschnitt Supported distributions stellt eine Tabelle bereit, in der aufgelistet wird, welche Versionen von .NET im Paketfeed verfügbar sind. Weitere Informationen finden Sie unter Ubuntu .NET Backports-Paketrepository.

Führen Sie zum Hinzufügen dieses Paket-Repositorys die folgenden Befehle aus:

sudo add-apt-repository ppa:dotnet/backports
sudo apt update

Registrieren des Ubuntu-.NET Backports-Paket-Repositorys

Öffnen Sie ein Terminal, und führen Sie den folgenden Befehl aus:

sudo add-apt-repository ppa:dotnet/backports

Aufheben der Registrierung des Ubuntu .NET Backports-Paket-Repositorys

Wenn Sie keine Pakete mehr aus dem Ubuntu .NET Backports-Paket-Repository nutzen möchten, können Sie die Registrierung aufheben. Öffnen Sie ein Terminal, und führen Sie den folgenden Befehl aus:

sudo add-apt-repository --remove ppa:dotnet/backports

Add-apt-repository-Befehl nicht gefunden

Das add-apt-repository(1) Dienstprogramm ist auf den meisten Ubuntu-Installationen vorinstalliert.

Wenn Sie eine Fehlermeldung erhalten, dass der add-apt-repository Befehl nicht gefunden wurde, müssen Sie das software-properties-common Paket installieren, das diesen Befehl bereitstellt. Öffnen Sie ein Terminal, und führen Sie die folgenden Befehle aus:

sudo apt update
sudo apt install software-properties-common

Registrieren des Microsoft-Paket-Repositorys

Das Microsoft-Paket-Repository enthält alle Versionen von .NET, die zuvor oder derzeit mit Ihrer Version von Ubuntu unterstützt werden. Wenn Ihre Version von Ubuntu .NET-Pakete bereitstellt, müssen Sie die Ubuntu-Pakete entprioritisieren und das Microsoft-Repository verwenden. Anleitungen zum Herabstufen der Priorität der Pakete finden Sie unter I need a version of .NET that isn't provided by my Linux distribution.

Vorschauversionen sind im Microsoft-Paket-Repository nicht verfügbar. Weitere Informationen finden Sie unter Installieren von Vorschauversionen.

Die Installation mit APT kann mit einigen wenigen Befehlen erfolgen. Führen Sie vor der Installation .NET die folgenden Befehle aus, um der Liste der vertrauenswürdigen Schlüssel den Microsoft-Paketsignaturschlüssel hinzuzufügen und das Paket-Repository hinzuzufügen.

Öffnen Sie ein Terminal, und führen Sie die folgenden Befehle aus:

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

# Download Microsoft signing key and repository
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/packages-microsoft-prod.deb -O packages-microsoft-prod.deb

# Install Microsoft signing key and repository
sudo dpkg -i packages-microsoft-prod.deb

# Clean up
rm packages-microsoft-prod.deb

# Update packages
sudo apt update

Installieren, Deinstallieren oder Aktualisieren von .NET

In den folgenden Abschnitten wird beschrieben, wie sie .NET über den Paket-Manager verwalten.

Installieren von .NET

Installieren Sie .NET über den Paket-Manager mit dem Befehl sudo apt install <package-name>. Ersetzen Sie <package-name> durch den Namen des .NET Pakets, das Sie installieren möchten. Um z. B. .NET SDK 10.0 zu installieren, verwenden Sie den Befehl sudo apt install dotnet-sdk-10.0. In der folgenden Tabelle sind die derzeit unterstützten .NET Pakete aufgeführt (die je nach Ihrer Ubuntu-Version variieren könnten):

Einige Umgebungsvariablen wirken sich darauf aus, wie .NET nach der Installation ausgeführt wird. Weitere Informationen finden Sie unter .NET SDK- und CLI-Umgebungsvariablen.

Deinstallieren .NET

Wenn Sie .NET über einen Paket-Manager installiert haben, deinstallieren Sie auf die gleiche Weise wie der Befehl apt-get remove:

sudo apt-get remove dotnet-sdk-6.0

Weitere Informationen finden Sie unter Uninstall .NET.

Aktualisieren von .NET

Wenn Sie .NET über einen Paket-Manager installiert haben, können Sie das Paket mit dem Befehl apt upgrade aktualisieren. Beispielsweise aktualisieren die folgenden Befehle das dotnet-sdk-10.0 Paket mit der neuesten Version:

sudo apt update
sudo apt upgrade dotnet-sdk-10.0

Verwalten von Vorschauversionen

In den folgenden Abschnitten wird beschrieben, wie Vorschauversionen von .NET installiert und deinstalliert werden.

Installieren von Vorschauversionen

Vorschau- und Releasekandidatenversionen von .NET sind in Paketrepositorys nicht verfügbar. Sie können Vorschauen installieren und Kandidaten von .NET auf eine der folgenden Arten freigeben:

• Skriptierte Installation mit install-dotnet.sh
• Manuelle binäre Extraktion

Entfernen von Vorschauversionen

Wenn Sie einen Paket-Manager zum Verwalten Ihrer Installation von .NET verwenden, tritt möglicherweise ein Konflikt auf, wenn Sie zuvor eine Vorschauversion installiert haben. Der Paket-Manager interpretiert die Nichtvorschauversion möglicherweise als frühere Version von .NET. Um die Nichtvorschauversion zu installieren, deinstallieren Sie zuerst die Vorschauversionen. Weitere Informationen zum Deinstallieren von .NET finden Sie unter Wie entfernen Sie die .NET Runtime und sdk.

Problembehandlung

Ab Ubuntu 22.04 kann es vorkommen, dass nur ein Stück .NET verfügbar ist. Beispielsweise haben Sie die Laufzeit und das SDK installiert, aber wenn Sie dotnet --info ausführen, wird nur die Laufzeit aufgeführt. Diese Situation kann mit der Verwendung von zwei verschiedenen Paketquellen zusammenhängen. Die integrierten Ubuntu 22.04- und Ubuntu 22.10-Paketfeeds enthalten einige Versionen von .NET, aber nicht alle, und Sie haben möglicherweise auch .NET aus den Microsoft-Feeds installiert. Weitere Informationen zum Beheben dieses Problems finden Sie unter Troubleshoot .NET Fehler im Zusammenhang mit fehlenden Dateien unter Linux.

APT-Probleme

Dieser Abschnitt enthält Informationen zu häufig auftretenden Fehlern, die Bei der Verwendung von APT zum Installieren von .NET auftreten können.

Paket konnte nicht gefunden werden

Weitere Informationen zum Installieren von .NET ohne einen Paket-Manager finden Sie in einem der folgenden Artikel:

• Verwenden Sie das install-dotnet Skript, um .NET zu installieren.
• Installieren Sie .NET manuell.

Konnte nicht gefunden werden \ Einige Pakete konnten nicht installiert werden.

Wenn Sie eine Fehlermeldung erhalten, die etwa lautet Paket {dotnet-package} konnte nicht gefunden werden oder Einige Pakete konnten nicht installiert werden, führen Sie die folgenden Befehle aus.

Es gibt zwei Platzhalter in der folgenden Gruppe von Befehlen.

• {dotnet-package}
  Dies stellt das .NET Paket dar, das Sie installieren, z. B. aspnetcore-runtime-8.0. Dies wird im folgenden sudo apt-get install Befehl verwendet.

Versuchen Sie zunächst, die Paketliste zu löschen:

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

Versuchen Sie dann erneut, .NET zu installieren. Wenn dies nicht funktioniert, können Sie eine manuelle Installation mit den folgenden Befehlen ausführen:

Wenn Sie Ubuntu 23.10 oder höher verwenden, probieren Sie die folgenden Befehle aus:

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

Wenn Sie eine Ubuntu-Version vor 23.10 verwenden, probieren Sie die folgenden Befehle aus:

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

Fehler beim Abrufen

Beim Installieren des .NET-Pakets wird möglicherweise ein Fehler wie Failed to fetch ... File has unexpected size ... Mirror sync in progress? angezeigt. Dieser Fehler kann bedeuten, dass der Paketfeed für .NET mit neueren Paketversionen aktualisiert wird und Sie es später erneut versuchen sollten. Während eines Upgrades sollte der Paketfeed nicht für mehr als 30 Minuten nicht verfügbar sein. Wenn Sie diesen Fehler kontinuierlich für mehr als 30 Minuten erhalten, melden Sie bitte ein Problem bei https://github.com/dotnet/core/issues.

Abhängigkeiten

Wenn die Installation mit einem Paket-Manager erfolgt, werden diese Bibliotheken für Sie installiert. Wenn Sie jedoch .NET manuell installieren oder eine eigenständige App veröffentlichen, müssen Sie diese Abhängigkeiten installieren, um Ihre App auszuführen:

• CA-Zertifikate
• libc6
• libgcc1 (für 16.x und 18.x)
• libgcc-s1 (für 20.x oder höher)
• libgssapi-krb5-2
• libicu55 (für 16.x)
• libicu60 (für 18.x)
• libicu66 (für 20.x)
• libicu70 (für 22.04)
• libicu72 (für 23.10)
• libicu74 (für 24.04)
• libicu76 (für 25.04 oder höher)
• libssl1.0.0 (für 16.x)
• libssl1.1 (für 18.x, 20.x)
• libssl3 (für 22.x oder höher)
• libstdc++6
• tzdata
• zlib1g

Abhängigkeiten können mit dem Befehl apt install installiert werden Der folgende Codeschnipsel veranschaulicht die Installation der zlib1g-Bibliothek:

sudo apt install zlib1g

Nächste Schritte

• Übersicht über .NET CLI
• Wie kann der Tab-Abschluss für die .NET CLI aktiviert werden
• Tutorial: Erstellen einer Konsolenanwendung mit .NET