Installeer .NET in Linux met behulp van een installatiescript of door binaire bestanden te extraheren

In dit artikel wordt gedemonstreerd hoe u de .NET SDK of de .NET Runtime op Linux installeert met behulp van het installatiescript of door de binaire bestanden te extraheren. Zie Install .NET on Linux voor een lijst met distributies die ondersteuning bieden voor het ingebouwde pakketbeheer.

Installeer de SDK (inclusief de runtime) als u .NET-apps wilt ontwikkelen. Als u alleen apps hoeft uit te voeren, installeert u runtime. Als u runtime installeert, wordt u aangeraden de ASP.NET Core Runtime te installeren, omdat deze zowel .NET als ASP.NET Core runtimes bevat.

Gebruik de dotnet --list-sdks en dotnet --list-runtimes opdrachten om te zien welke versies zijn geïnstalleerd. Zie Het controleren of .NET al is geïnstalleerd voor meer informatie.

.NET releases

Er zijn twee soorten ondersteunde releases, LTS (Long Term Support) en Standard Term Support (STS). De kwaliteit van alle releases is hetzelfde. Het enige verschil is de lengte van de ondersteuning. LTS-releases krijgen drie jaar gratis ondersteuning en patches. STS-releases krijgen twee jaar gratis ondersteuning en patches. Zie .NET Ondersteuningsbeleid voor meer informatie.

De volgende tabel bevat de ondersteuningsstatus van elke versie van .NET (en .NET Core):

Afhankelijkheden

Het is mogelijk dat wanneer u .NET installeert, bepaalde afhankelijkheden mogelijk niet worden geïnstalleerd, bijvoorbeeld wanneer u manually installeert. De volgende lijst bevat informatie over Linux-distributies die worden ondersteund door Microsoft en afhankelijkheden hebben die u mogelijk moet installeren. Controleer de distributiepagina voor meer informatie:

• Alpen
• Debian
• Fedora
• RHEL en CentOS Stream
• SLES
• Ubuntu

Zie Zelfstandige Linux-apps voor algemene informatie over de afhankelijkheden.

RPM-afhankelijkheden

Als uw distributie niet eerder werd vermeld en RPM is gebaseerd, hebt u mogelijk de volgende afhankelijkheden nodig:

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

DEB-afhankelijkheden

Als uw distributie niet eerder werd vermeld en debian is gebaseerd, hebt u mogelijk de volgende afhankelijkheden nodig:

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

Geautomatiseerde scriptinstallatie

De dotnet-install-scripts worden gebruikt voor automatisering en niet-beheerdersinstallatie van de SDK en Runtime. U kunt het script downloaden van https://dot.net/v1/dotnet-install.sh. Wanneer .NET op deze manier is geïnstalleerd, moet u de afhankelijkheden installeren die vereist zijn voor uw Linux-distributie. Gebruik de koppelingen in het artikel Install .NET op Linux voor uw specifieke Linux-distributie.

U kunt het script downloaden met wget:

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

Of, met curl:

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

Voordat u dit script uitvoert, moet u ervoor zorgen dat u toestemming verleent om dit script uit te voeren als uitvoerbaar bestand:

chmod +x ./dotnet-install.sh

Het script installeert standaard de nieuwste long term support (LTS) SDK-versie, die .NET 10 is. Als u de nieuwste versie wilt installeren, die mogelijk geen (LTS)-versie is, gebruikt u de --version latest parameter.

./dotnet-install.sh --version latest

Als u .NET Runtime wilt installeren in plaats van de SDK, gebruikt u de parameter --runtime.

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

U kunt een specifieke primaire versie installeren met de --channel parameter om de specifieke versie aan te geven. Met de volgende opdracht wordt .NET 9.0 SDK geïnstalleerd.

./dotnet-install.sh --channel 9.0

Zie de naslaginformatie over dotnet-install scripts voor meer informatie.

Zie Omgevingsvariabelen systeem-breed instellen om .NET in te schakelen op de opdrachtregel.

Zie .NET CLI-overzicht voor meer informatie over het gebruik van de .NET CLI.

Handmatige installatie

Als alternatief voor pakketbeheerders kunt u de SDK en runtime downloaden en handmatig installeren. Handmatige installatie wordt vaak gebruikt als onderdeel van continue integratietests of op een niet-ondersteunde Linux-distributie. Voor een ontwikkelaar of gebruiker is het beter om een pakketbeheerder te gebruiken.

Download een binaire release voor de SDK of de runtime van een van de volgende sites. De .NET SDK bevat de bijbehorende runtime:

• ✔️ .NET 10 downloads
• ✔️ .NET 9 downloads
• ✔️ .NET 8 downloads
• Alle .NET Core-downloads

Pak het gedownloade bestand uit en gebruik de opdracht export om DOTNET_ROOT in te stellen op de locatie van de uitgepakte map en zorg ervoor dat .NET zich in PATH bevindt. Als u DOTNET_ROOT exporteert, worden de .NET CLI-opdrachten beschikbaar in de terminal. Zie voor meer informatie over .NET omgevingsvariabelen .NET SDK en CLI-omgevingsvariabelen.

Verschillende versies van .NET kunnen worden geëxtraheerd naar dezelfde map, die naast elkaar bestaan.

Voorbeeld

De volgende opdrachten gebruiken Bash om de omgevingsvariabele DOTNET_ROOT in te stellen op de huidige werkmap, gevolgd door .dotnet. Als deze map niet bestaat, wordt deze aangemaakt. De omgevingsvariabele DOTNET_FILE is de bestandsnaam van de .NET binaire release die u wilt installeren. Dit bestand wordt geëxtraheerd naar de DOTNET_ROOT map. Zowel de DOTNET_ROOT map als de tools submap worden toegevoegd aan de PATH omgevingsvariabele.

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

U kunt meer dan één versie van .NET in dezelfde map installeren.

U kunt .NET ook installeren in de thuisdirectory die wordt geïdentificeerd door de variabele HOME of het pad ~.

export DOTNET_ROOT=$HOME/.dotnet

Zie .NET CLI-overzicht voor meer informatie over het gebruik van de .NET CLI.

Gedownloade binaire bestanden controleren

Nadat u een installatieprogramma of binaire versie hebt gedownload, controleert u of het bestand niet is gewijzigd of beschadigd. U kunt de controlesom op uw computer controleren en deze vergelijken met wat er is gerapporteerd op de downloadwebsite.

Wanneer u het bestand downloadt vanaf een officiële downloadpagina, wordt de controlesom voor het bestand weergegeven in een tekstvak. Selecteer de knop Kopiëren om de waarde van de controlesom naar het klembord te kopiëren.

Gebruik de sha512sum opdracht om de controlesom af te drukken van het bestand dat u hebt gedownload. Met de volgende opdracht wordt bijvoorbeeld de controlesom van het dotnet-sdk-9.0.306-linux-x64.tar.gz-bestand gerapporteerd:

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

Vergelijk de controlesom met de waarde van de downloadsite.

Een controlesombestand gebruiken om te valideren

De .NET releaseopmerkingen bevatten een koppeling naar een controlesombestand dat u kunt gebruiken om het gedownloade bestand te valideren. In de volgende stappen wordt beschreven hoe u het controlegetallenbestand downloadt en een .NET-installatieprogramma valideert:

1. De releaseopmerkingenpagina voor .NET 9 op GitHub op https://github.com/dotnet/core/tree/main/release-notes/9.0#releases bevat een sectie met de naam Releases. De tabel in dat gedeelte verwijst naar de downloads en controlesombestanden voor elke release van .NET 9. In de volgende afbeelding ziet u de releasetabel .NET 8 als referentie:

   

2. Selecteer de koppeling voor de versie van .NET die u hebt gedownload.

   In de vorige sectie is .NET SDK 9.0.306 gebruikt. Deze bevindt zich in de release van .NET 9.0.10.

3. Op de releasepagina ziet u de .NET Runtime- en .NET SDK-versie en een koppeling naar het controlesombestand. In de volgende afbeelding ziet u de releasetabel .NET 8 als referentie:

   

4. Klik met de rechtermuisknop op de koppeling Checksum en kopieer deze naar het klembord.

5. Open een terminal.

6. Gebruik curl -O {link} om het controlesombestand te downloaden.

   Vervang de koppeling in de volgende opdracht door de koppeling die u hebt gekopieerd.

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

7. Met zowel het checksum-bestand als het .NET-releasebestand gedownload naar dezelfde directory, gebruikt u de opdracht sha512sum -c {file} --ignore-missing om het gedownloade bestand te valideren.

   Wanneer de validatie is geslaagd, ziet u dat het bestand wordt afgedrukt met de status OK :

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

   Als u het bestand ziet dat is gemarkeerd als MISLUKT, is het bestand dat u hebt gedownload, niet geldig en mag het niet worden gebruikt.

   $ 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
   

Omgevingsvariabelen instellen voor het hele systeem

Als u het vorige installatiescript hebt gebruikt, zijn de variabelen die zijn ingesteld alleen van toepassing op uw huidige terminalsessie. Voeg ze toe aan uw shell-profiel. Er zijn veel verschillende shells beschikbaar voor Linux en elk heeft een ander profiel. Voorbeeld:

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

Stel de volgende twee omgevingsvariabelen in uw shell-profiel in:

• DOTNET_ROOT

  Deze variabele is ingesteld op de map waar .NET is geïnstalleerd, zoals $HOME/.dotnet:

  export DOTNET_ROOT=$HOME/.dotnet
  

• PATH

  Deze variabele moet zowel de DOTNET_ROOT map als de DOTNET_ROOT/tools map bevatten:

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

Volgende stappen

• overzicht van .NET CLI
• De tab-voltooiing voor de .NET CLI inschakelen
• Tutorial: Een consoletoepassing maken met .NET