Installare .NET SDK o il runtime di .NET in Debian

Questo articolo descrive come installare .NET in Debian. Quando una versione debian non è supportata, .NET non è più supportata con tale versione. Tuttavia, queste istruzioni possono essere utili per ottenere .NET in esecuzione in tali versioni, anche se non è supportata.

Installare l'SDK (che include il runtime) se si vuole sviluppare app .NET. Se si vogliono solo eseguire app, è sufficiente installare il runtime. Se si installa il runtime, è consigliabile installare ASP.NET Core Runtime in quanto include sia runtime .NET che ASP.NET Core.

Usare i comandi dotnet --list-sdks e dotnet --list-runtimes per vedere quali sono le versioni installate. Per altre informazioni, vedere Come verificare che .NET sia già installato.

Distribuzioni supportate

La tabella seguente è un elenco delle versioni attualmente supportate .NET e delle versioni di Debian in cui sono supportate. Queste versioni rimangono supportate fino a quando la versione di .NET raggiunge la fine del supporto o la versione di Debian raggiunge la fine del ciclo di vita.

Le versioni seguenti di .NET sono ❌ non più supportate:

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

Installare le versioni di anteprima

Le versioni candidate di anteprima e rilascio di .NET non sono disponibili nei repository di pacchetti. È possibile installare anteprime e rilasciare candidati di .NET in uno dei modi seguenti:

• Installazione tramite script con install-dotnet.sh
• Estrazione manuale del file binario

Rimuovere le versioni di anteprima

Quando si usa una gestione pacchetti per gestire l'installazione di .NET, è possibile che si verifichi un conflitto se in precedenza è stata installata una versione di anteprima. La gestione pacchetti può interpretare la versione non di anteprima come una versione precedente di .NET. Per installare la versione non di anteprima, disinstallare prima di tutto le versioni di anteprima. Per altre informazioni sulla disinstallazione di .NET, vedere Come rimuovere .NET Runtime e SDK.

Debian 13

L'installazione con APT può essere eseguita con pochi comandi. Prima di installare .NET, eseguire i comandi seguenti per aggiungere la chiave di firma del pacchetto Microsoft all'elenco di chiavi attendibili e aggiungere il repository dei pacchetti.

Aprire un terminale ed eseguire i comandi seguenti:

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

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

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

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

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

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

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

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

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

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

Debian 12

L'installazione con APT può essere eseguita con pochi comandi. Prima di installare .NET, eseguire i comandi seguenti per aggiungere la chiave di firma del pacchetto Microsoft all'elenco di chiavi attendibili e aggiungere il repository dei pacchetti.

Aprire un terminale ed eseguire i comandi seguenti:

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

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

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

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

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

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

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

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

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

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

Usare APT per aggiornare .NET

Quando è disponibile una nuova versione patch per .NET, è possibile aggiornarla tramite APT con i comandi seguenti:

sudo apt-get update
sudo apt-get upgrade

Se è stata aggiornata la distribuzione di Linux dall'installazione di .NET, potrebbe essere necessario riconfigurare il repository di pacchetti Microsoft. Eseguire le istruzioni di installazione per la versione di distribuzione corrente per eseguire l'aggiornamento al repository di pacchetti appropriato per gli aggiornamenti .NET.

Risoluzione dei problemi

Questa sezione fornisce informazioni sugli errori comuni che possono verificarsi durante l'uso di APT per installare .NET.

Non è possibile trovare il pacchetto

Non è possibile trovare il pacchetto\Non è stato possibile installare alcuni pacchetti

Se viene visualizzato un messaggio di errore simile a Non è possibile trovare il pacchetto {dotnet-package} o Non è stato possibile installare alcuni pacchetti, eseguire i comandi seguenti.

Nel seguente insieme di comandi sono presenti due segnaposto.

• {dotnet-package}
  Rappresenta il pacchetto .NET che si sta installando, ad esempio aspnetcore-runtime-8.0. Viene usato nel comando sudo apt-get install seguente.

Prima di tutto, provare a ripulire l'elenco di pacchetti:

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

Provare quindi a installare di nuovo .NET. Se la soluzione non funziona, è possibile eseguire un'installazione manuale con i comandi seguenti:

Se si usa Debian 12 o versione successiva, provare i comandi seguenti:

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

Se si usa una versione Debian precedente a 12, provare i comandi seguenti:

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

Non è possibile recuperare il pacchetto

Durante l'installazione del pacchetto .NET, è possibile che venga visualizzato un errore simile a Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Questo errore potrebbe significare che il feed di pacchetti per .NET viene aggiornato con le versioni più recenti del pacchetto e che è necessario riprovare più tardi. Durante un aggiornamento, il feed di pacchetti non dovrebbe restare non disponibile per più di 30 minuti. Se si riceve questo errore per più di 30 minuti, segnalare il problema all'indirizzo https://github.com/dotnet/core/issues.

Dipendenze

Quando si installa mediante uno strumento di gestione pacchetti, queste librerie vengono installate automaticamente. Tuttavia, se si installa manualmente .NET o si pubblica un'app autonoma, è necessario assicurarsi che queste librerie siano installate:

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

Altre note

È possibile installare le dipendenze con il comando apt install. Il frammento di codice seguente dimostra l'installazione della libreria libc6:

sudo apt install libc6

Passaggi successivi

• Panoramica dell'interfaccia della riga di comando di .NET
• Come abilitare il completamento automatico con TAB per la CLI di .NET
• Tutorial: Creare un'applicazione console con .NET