Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Artikel wird beschrieben, wie sie .NET auf Debian installieren. Wenn eine Debian-Version nicht mehr unterstützt wird, wird .NET nicht mehr mit dieser Version unterstützt. Diese Anweisungen können Ihnen jedoch helfen, .NET auf diesen Versionen auszuführen, obwohl sie nicht unterstützt wird.
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.
Unterstützte Distributionen
Die folgende Tabelle ist eine Liste der derzeit unterstützten .NET Versionen und der Versionen von Debian, auf der sie unterstützt werden. Diese Versionen werden weiterhin unterstützt, bis die Version von .NET das Ende des Supports erreicht oder die Version von Debian das Ende der Lebensdauer erreicht.
| Debian | .NET |
|---|---|
| 13 | 10, 9, 8 |
| 12 | 10, 9, 8 |
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
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:
- Skriptgesteuerte 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. Für die Installation der Nichtvorschauversion müssen Sie zunächst die Vorschauversionen deinstallieren. Weitere Informationen zum Deinstallieren von .NET finden Sie unter Wie entfernen Sie die .NET Runtime und sdk.
Debian 13
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:
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
Wichtig
Der Microsoft-Paketfeed veröffentlicht nur x64 und Arm64pakete für .NET 10. Wenn Sie .NET auf anderen Architekturen wie Arm32 installieren müssen, verwenden Sie keinen Paket-Manager mit dem Microsoft-Paketfeed. Weitere Informationen zum Installieren von .NET ohne einen Paketmanager, finden Sie in einem der folgenden Artikel.
Installieren des SDKs
Mit dem .NET SDK können Sie Apps mit .NET entwickeln. Wenn Sie das .NET SDK installieren, müssen Sie die entsprechende Laufzeit nicht installieren. Führen Sie die folgenden Befehle aus, um das .NET SDK zu installieren:
sudo apt-get update && \
sudo apt-get install -y dotnet-sdk-10.0
Informationen zur Verwendung der .NET CLI finden Sie unter .NET CLI-Übersicht.
Runtime installieren
Mit der ASP.NET Core Runtime können Sie Apps ausführen, die mit .NET erstellt wurden, die die Laufzeit nicht bereitgestellt haben. Mit den folgenden Befehlen wird die ASP.NET Core Runtime installiert, bei der es sich um die kompatibelste Laufzeit für .NET handelt. Führen Sie in Ihrem Terminal die folgenden Befehle aus:
sudo apt-get update && \
sudo apt-get install -y aspnetcore-runtime-10.0
Alternativ zur ASP.NET Core Runtime können Sie die .NET Runtime installieren, die nicht ASP.NET Core Unterstützung enthält: ersetzen Sie aspnetcore-runtime-10.0 im vorherigen Befehl durch dotnet-runtime-10.0:
sudo apt-get install -y dotnet-runtime-10.0
Informationen zur Verwendung der .NET CLI finden Sie unter .NET CLI-Übersicht.
Debian 12
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:
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
Wichtig
Der Microsoft-Paketfeed veröffentlicht nur x64 und Arm64pakete für .NET 10. Wenn Sie .NET auf anderen Architekturen wie Arm32 installieren müssen, verwenden Sie keinen Paket-Manager mit dem Microsoft-Paketfeed. Weitere Informationen zum Installieren von .NET ohne einen Paketmanager, finden Sie in einem der folgenden Artikel.
Installieren des SDKs
Mit dem .NET SDK können Sie Apps mit .NET entwickeln. Wenn Sie das .NET SDK installieren, müssen Sie die entsprechende Laufzeit nicht installieren. Führen Sie die folgenden Befehle aus, um das .NET SDK zu installieren:
sudo apt-get update && \
sudo apt-get install -y dotnet-sdk-10.0
Informationen zur Verwendung der .NET CLI finden Sie unter .NET CLI-Übersicht.
Runtime installieren
Mit der ASP.NET Core Runtime können Sie Apps ausführen, die mit .NET erstellt wurden, die die Laufzeit nicht bereitgestellt haben. Mit den folgenden Befehlen wird die ASP.NET Core Runtime installiert, bei der es sich um die kompatibelste Laufzeit für .NET handelt. Führen Sie in Ihrem Terminal die folgenden Befehle aus:
sudo apt-get update && \
sudo apt-get install -y aspnetcore-runtime-10.0
Alternativ zur ASP.NET Core Runtime können Sie die .NET Runtime installieren, die nicht ASP.NET Core Unterstützung enthält: ersetzen Sie aspnetcore-runtime-10.0 im vorherigen Befehl durch dotnet-runtime-10.0:
sudo apt-get install -y dotnet-runtime-10.0
Informationen zur Verwendung der .NET CLI finden Sie unter .NET CLI-Übersicht.
Verwenden von APT zum Aktualisieren von .NET
Wenn eine neue Patchversion für .NET verfügbar ist, können Sie es über APT mit den folgenden Befehlen aktualisieren:
sudo apt-get update
sudo apt-get upgrade
Wenn Sie die Linux-Verteilung seit der Installation von .NET aktualisiert haben, müssen Sie möglicherweise das Microsoft-Paket-Repository neu konfigurieren. Führen Sie die Installationsanweisungen für Ihre aktuelle Verteilerversion aus, um ein Upgrade auf das entsprechende Paket-Repository für .NET Updates durchzuführen.
Problembehandlung
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
Wichtig
Der Microsoft-Paketfeed veröffentlicht Pakete für unterschiedliche Architekturen je nach .NET Version:
- .NET 10: x64- und Arm64-Pakete nur.
- .NET 9: nur pakete x64.
- .NET 8: nur pakete x64.
Wenn Sie .NET auf anderen Architekturen wie Arm32 installieren müssen, verwenden Sie keinen Paket-Manager mit dem Microsoft-Paketfeed. Weitere Informationen zum Installieren von .NET ohne einen Paketmanager, finden Sie in einem der folgenden Artikel.
Einige Pakete konnten nicht gefunden werden \ Einige Pakete konnten nicht installiert werden
Wenn eine Fehlermeldung wie Unable to locate package {dotnet-package} (Das Paket {dotnet-package} konnte nicht gefunden werden) oder Some packages could not be installed (Einige Pakete konnten nicht installiert werden) angezeigt wird, führen Sie die folgenden Befehle aus.
Die folgende Befehlsgruppe enthält zwei Platzhalter.
{dotnet-package}
Dies stellt das .NET Paket dar, das Sie installieren, z. B.aspnetcore-runtime-8.0. Dies wird im folgenden 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 mithilfe der folgenden Befehle eine manuelle Installation ausführen:
Wenn Sie Debian 12 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 Debian-Version verwenden, die älter als 12 ist, 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 darf der Paketfeed maximal 30 Minuten nicht verfügbar sein. Wenn dieser Fehler länger als 30 Minuten auftritt, melden Sie ein Problem unter .
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 sicherstellen, dass diese Bibliotheken installiert sind:
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
Sonstige Hinweise
Abhängigkeiten können mit dem Befehl installiert werden Der folgende Codeschnipsel veranschaulicht die Installation der -Bibliothek:
sudo apt install libc6
Nächste Schritte
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
