Dela via

Installera .NET på Linux med hjälp av ett installationsskript eller genom att extrahera binärfiler

  • Artikel

Den här artikeln visar hur du installerar .NET SDK eller .NET Runtime på Linux med hjälp av installationsskriptet eller genom att extrahera binärfilerna. En lista över distributioner som stöder den inbyggda pakethanteraren finns i Installera .NET på Linux.

Installera SDK :et (som innehåller körningen) om du vill utveckla .NET-appar. Eller om du bara behöver köra appar installerar du Runtime. Om du installerar Runtime rekommenderar vi att du installerar ASP.NET Core Runtime eftersom den innehåller både .NET- och ASP.NET Core-körningar.

Använd kommandona dotnet --list-sdks och dotnet --list-runtimes för att se vilka versioner som är installerade. Mer information finns i Så här kontrollerar du att .NET redan är installerat.

.NET-versioner

Det finns två typer av versioner som stöds, LTS-versioner (Long Term Support) eller Standard Term Support (STS). Kvaliteten på alla utgåvor är densamma. Den enda skillnaden är supportens längd. LTS-versioner får kostnadsfri support och korrigeringar i 3 år. STS-versioner får kostnadsfri support och korrigeringar i 18 månader. Mer information finns i .NET-supportprincip.

I följande tabell visas supportstatus för varje version av .NET (och .NET Core):

✔️ Stödd ❌ Unsupported
8 (LTS) 7
6 (LTS) 5
3.1
3,0
2,2
2.1
2.0
1,1
1.0

Beroenden

När du installerar .NET kan det hända att vissa beroenden inte installeras, till exempel när du installerar manuellt. I följande lista beskrivs Linux-distributioner som stöds av Microsoft och som har beroenden som du kan behöva installera. Mer information finns på distributionssidan:

Allmän information om beroendena finns i Fristående Linux-appar.

RPM-beroenden

Om distributionen inte fanns med i listan tidigare och är RPM-baserad kan du behöva följande beroenden:

  • krb5-libs
  • libicu
  • openssl-libs

DEB-beroenden

Om din distribution inte tidigare fanns med i listan och är debianbaserad kan du behöva följande beroenden:

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

Vanliga beroenden

Om .NET-appen använder sammansättningen System.Drawing.Common måste även libgdiplus installeras. Eftersom System.Drawing.Common inte längre stöds i Linux fungerar detta bara på .NET 6 och kräver att du ställer in körningskonfigurationsväxeln System.Drawing.EnableUnixSupport .

Du kan vanligtvis installera en ny version av libgdiplus genom att lägga till Mono-lagringsplatsen i systemet.

Skriptad installation

Skripten för dotnet-install används för automatisering och icke-administratörsinstallationer av SDK och Runtime. Du kan ladda ned skriptet från https://dot.net/v1/dotnet-install.sh. När .NET installeras på det här sättet måste du installera de beroenden som krävs av Din Linux-distribution. Använd länkarna i artikeln Installera .NET på Linux för din specifika Linux-distribution.

Viktigt!

Bash krävs för att köra skriptet.

Du kan ladda ned skriptet med wget:

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

Innan du kör det här skriptet måste du ge skriptet behörighet att köras som en körbar fil:

chmod +x ./dotnet-install.sh

Skriptet installerar som standard den senaste SDK-versionen (long term support) (LTS), som är .NET 8. Om du vill installera den senaste versionen, som kanske inte är en (LTS)-version, använder du parametern --version latest .

./dotnet-install.sh --version latest

Om du vill installera .NET Runtime i stället för SDK använder du parametern --runtime .

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

Du kan installera en specifik huvudversion med parametern --channel för att ange den specifika versionen. Följande kommando installerar .NET 8.0 SDK.

./dotnet-install.sh --channel 8.0

Mer information finns i referensen för dotnet-install-skript.

Information om hur du aktiverar .NET på kommandoraden finns i Ange miljövariabler i hela systemet.

Information om hur du använder .NET CLI finns i .NET CLI-översikt.

Manuell installation

Som ett alternativ till pakethanterare kan du ladda ned och installera SDK:t och körningen manuellt. Manuell installation används ofta som en del av kontinuerlig integreringstestning eller i en Linux-distribution som inte stöds. För en utvecklare eller användare är det bättre att använda en pakethanterare.

Ladda ned en binär version för antingen SDK:t eller körningen från någon av följande platser. .NET SDK innehåller motsvarande körning:

Extrahera den nedladdade filen och använd export kommandot för att ange DOTNET_ROOT platsen för den extraherade mappen och se sedan till att .NET finns i PATH. När du exporterar DOTNET_ROOT blir .NET CLI-kommandona tillgängliga i terminalen. Mer information om .NET-miljövariabler finns i miljövariabler för .NET SDK och CLI.

Olika versioner av .NET kan extraheras till samma mapp, som samexisterar sida vid sida.

Exempel

Följande kommandon använder Bash för att ange miljövariabeln DOTNET_ROOT till den aktuella arbetskatalogen följt av .dotnet. Katalogen skapas om den inte finns. Miljövariabeln DOTNET_FILE är filnamnet för den binära .NET-version som du vill installera. Den här filen extraheras till DOTNET_ROOT katalogen. DOTNET_ROOT Både katalogen och dess tools underkatalog läggs till i PATH miljövariabeln.

Viktigt!

Om du kör de här kommandona ska du komma ihåg att ändra DOTNET_FILE värdet till namnet på den .NET-binärfil som du laddade ned.

DOTNET_FILE=dotnet-sdk-8.0.100-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

Du kan installera mer än en version av .NET i samma mapp.

Du kan också installera .NET i hemkatalogen som identifieras av variabeln HOME eller ~ sökvägen:

export DOTNET_ROOT=$HOME/.dotnet

Information om hur du använder .NET CLI finns i .NET CLI-översikt.

Verifiera nedladdade binärfiler

När du har laddat ned ett installationsprogram eller en binär version kontrollerar du att filen inte har ändrats eller skadats. Du kan kontrollera kontrollsumman på datorn och sedan jämföra den med vad som rapporterades på nedladdningswebbplatsen.

När du laddar ned filen från en officiell nedladdningssida visas kontrollsumman för filen i en textruta. Välj knappen Kopiera för att kopiera kontrollsummavärdet till Urklipp.

Nedladdningssidan för .NET med kontrollsumma

sha512sum Använd kommandot för att skriva ut kontrollsumman för filen som du har laddat ned. Följande kommando rapporterar till exempel kontrollsumman för filen dotnet-sdk-8.0.100-linux-x64.tar.gz :

$ sha512sum dotnet-sdk-8.0.100-linux-x64.tar.gz
13905ea20191e70baeba50b0e9bbe5f752a7c34587878ee104744f9fb453bfe439994d38969722bdae7f60ee047d75dda8636f3ab62659450e9cd4024f38b2a5  dotnet-sdk-8.0.100-linux-x64.tar.gz

Jämför kontrollsumman med värdet som tillhandahålls av nedladdningswebbplatsen.

Viktigt!

Även om en Linux-fil visas i dessa exempel gäller den här informationen lika för macOS.

Använda en checksumfil för att verifiera

Viktig information om .NET innehåller en länk till en checksumfil som du kan använda för att verifiera den nedladdade filen. Följande steg beskriver hur du laddar ned checksum-filen och validerar en .NET-installationsbinär fil:

  1. Sidan viktig information för .NET 8 på GitHub på https://github.com/dotnet/core/tree/main/release-notes/8.0#releases innehåller ett avsnitt med namnet Versioner. Tabellen i det avsnittet länkar till nedladdningar och kontrollsummor för varje .NET 8-version:

    Versionstabellen för github-versionsanteckningar för .NET

  2. Välj länken för den version av .NET som du laddade ned.

    I föregående avsnitt användes .NET SDK 8.0.100, som finns i .NET 8.0.0-versionen.

  3. På versionssidan kan du se .NET Runtime- och .NET SDK-versionen och en länk till kontrollsummafilen:

    Nedladdningstabellen med kontrollsummor för .NET

  4. Högerklicka på länken Checksum och kopiera länken till Urklipp.

  5. Öppna en terminal.

  6. Använd curl -O {link} för att ladda ned checksum-filen.

    Ersätt länken i följande kommando med länken som du kopierade.

    curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt

  7. Med både checksum-filen och .NET-versionsfilen nedladdad till samma katalog använder du sha512sum -c {file} --ignore-missing kommandot för att verifiera den nedladdade filen.

    När valideringen har godkänts ser du att filen skrivs ut med OK-status :

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

    Om du ser filen markerad som MISSLYCKAD är filen du laddade ned inte giltig och bör inte användas.

    $ sha512sum -c 8.0.0-sha.txt --ignore-missing
dotnet-sdk-8.0.100-linux-x64.tar.gz: FAILED
sha512sum: WARNING: 1 computed checksum did NOT match
sha512sum: 8.0.0-sha.txt: no file was verified

Ange miljövariabler systemomfattande

Om du använde det tidigare installationsskriptet gäller variablerna som angetts endast för den aktuella terminalsessionen. Lägg till dem i din gränssnittsprofil. Det finns många olika gränssnitt för Linux och var och en har en annan profil. Till exempel:

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

Ange följande två miljövariabler i din gränssnittsprofil:

  • DOTNET_ROOT

    Den här variabeln är inställd på mappen .NET installerades till, till exempel $HOME/.dotnet:

    export DOTNET_ROOT=$HOME/.dotnet

  • PATH

    Den här variabeln bör innehålla både DOTNET_ROOT mappen och DOTNET_ROOT/tools mappen:

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

Nästa steg