Instalación de .NET en Linux mediante un script de instalación o mediante la extracción de archivos binarios

En este artículo se muestra cómo instalar el SDK de .NET o el entorno de ejecución de .NET en Linux mediante el script de instalación o mediante la extracción de los archivos binarios. Para obtener una lista de las distribuciones que admiten el administrador de paquetes integrado, consulte Install .NET en Linux.

Instale el SDK (que incluye el entorno de ejecución) si desea desarrollar aplicaciones .NET. O bien, si solo necesita ejecutar aplicaciones, instale el entorno de ejecución. Si va a instalar el entorno de ejecución, se recomienda instalar los entornos de ejecución de ASP.NET Core, ya que incluye los entornos de ejecución de .NET y ASP.NET Core.

Use los comandos y para ver qué versiones están instaladas. Para obtener más información, vea Cómo comprobar que .NET ya está instalado.

versiones de .NET

Hay dos tipos de versiones admitidas, soporte técnico a largo plazo (LTS) y soporte técnico estándar (STS). La calidad de todas las versiones es la misma. La única diferencia es la duración del soporte técnico. Las versiones de LTS obtienen soporte técnico gratuito y revisiones durante tres años. Las versiones de STS obtienen soporte técnico gratuito y revisiones durante dos años. Para obtener más información, consulte .NET Directiva de soporte técnico.

En la tabla siguiente se muestra el estado de compatibilidad de cada versión de .NET (y .NET Core):

Dependencias

Es posible que, al instalar .NET, no se instalen dependencias específicas, como cuando las instalas manualmente. En la lista siguiente se detallan las distribuciones de Linux compatibles con Microsoft y que tienen dependencias que es posible que necesite instalar. Consulte la página de la distribución para obtener más información:

• Alpino
• Debian
• Fedora
• RHEL y CentOS Stream
• SLES
• Ubuntu

Para obtener información genérica sobre las dependencias, vea Aplicaciones de Linux independientes.

Dependencias de RPM

Si la distribución no aparece anteriormente y está basada en RPM, es posible que necesite las siguientes dependencias:

• glibc
• libgcc
• certificados de entidad de certificación
• openssl-libs
• libstdc++
• libicu
• tzdata
• krb5-libs

Dependencias de DEB

Si la distribución no aparece anteriormente y está basada en debian, es posible que necesite las siguientes dependencias:

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

Instalación con script

Los scripts de dotnet-install se usan para la automatización y las instalaciones sin privilegios de administrador del SDK y del Runtime. Puede descargar el script desde https://dot.net/v1/dotnet-install.sh. Cuando se instala .NET de esta manera, debe instalar las dependencias requeridas por la distribución de Linux. Use los vínculos del artículo Install .NET en Linux para su distribución específica de Linux.

Puede descargar el script con :

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

O bien, con :

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

Antes de ejecutar este script, asegúrese de conceder permiso para que este script se ejecute como un ejecutable:

chmod +x ./dotnet-install.sh

El script tiene por defecto instalar la versión más reciente del SDK con soporte a largo plazo (LTS), que es .NET 10. Para instalar la versión más reciente, que podría no ser de LTS, use el parámetro .

./dotnet-install.sh --version latest

Para instalar .NET runtime en lugar del SDK, use el parámetro --runtime.

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

Para instalar una versión principal específica, use el parámetro para indicar la versión deseada. El siguiente comando instala .NET SDK 9.0.

./dotnet-install.sh --channel 9.0

Para más información, consulte la referencia de los scripts de dotnet-install.

Para habilitar .NET en la línea de comandos, consulte Configurar variables de entorno de todo el sistema.

Para obtener información sobre cómo usar la CLI de .NET, consulte .NET información general de la CLI.

Instalación manual

Como alternativa a los administradores de paquetes, puede descargar e instalar manualmente el SDK y el entorno de ejecución. La instalación manual se suele usar como parte de las pruebas de integración continua o en distribuciones de Linux no admitidas. Para un desarrollador o usuario, es mejor usar un administrador de paquetes.

Descargue una versión binaria del SDK o del runtime de uno de los siguientes sitios. El SDK de .NET incluye el entorno de ejecución correspondiente:

• ✔️ .NET 10 descargas
• ✔️ .NET 9 descargas
• ✔️ .NET 8 descargas
• Todas las descargas de .NET Core

Extraiga el archivo descargado y use el comando export para establecer DOTNET_ROOT en la ubicación de la carpeta extraída y, a continuación, asegúrese de que .NET esté en PATH. La exportación de DOTNET_ROOT hace que los comandos de la CLI de .NET estén disponibles en el terminal. Para obtener más información sobre las variables de entorno de .NET, consulte .NET SDK y variables de entorno de la CLI.

Se pueden extraer diferentes versiones de .NET en la misma carpeta, que coexisten en paralelo.

Ejemplo

Los siguientes comandos usan Bash para establecer la variable de entorno en el directorio de trabajo actual seguido de . Ese directorio se crea si no existe. La variable de entorno DOTNET_FILE es el nombre de archivo de la versión binaria .NET que desea instalar. Este archivo se extrae en el directorio. Tanto el directorio como su subdirectorio se agregan a la variable de entorno .

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

Puede instalar más de una versión de .NET en la misma carpeta.

También puede instalar .NET en el directorio personal identificado por la variable HOME o la ruta de acceso ~.

export DOTNET_ROOT=$HOME/.dotnet

Para obtener información sobre cómo usar la CLI de .NET, consulte .NET información general de la CLI.

Comprobación de los binarios descargados

Después de descargar un instalador o una versión binaria, compruébelo para asegurarse de que el archivo no se ha modificado ni dañado. Puede verificar la suma de comprobación en el equipo y, a continuación, compararla con lo notificado en el sitio web de descarga.

Al descargar un archivo desde una página de descarga oficial, la suma de comprobación del archivo se muestra en un cuadro de texto. Seleccione el botón Copiar para copiar el valor de la suma de comprobación al Portapapeles.

Use el comando para imprimir la suma de comprobación del archivo que ha descargado. Por ejemplo, el siguiente comando notifica la suma de comprobación del archivo dotnet-sdk-9.0.306-linux-x64.tar.gz :

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

Compare la suma de comprobación con el valor proporcionado por el sitio de descarga.

Uso de un archivo de suma de comprobación para validar

Las notas de la versión de .NET incluyen un enlace a un archivo de suma de verificación que puede usar para validar el archivo que ha descargado. En los pasos siguientes se describe cómo descargar el archivo de suma de comprobación y validar un archivo binario de instalación de .NET:

1. La página de notas de la versión de .NET 9 en GitHub en https://github.com/dotnet/core/tree/main/release-notes/9.0#releases contiene una sección denominada Releases. La tabla de esa sección se vincula a los archivos de descargas y suma de comprobación de cada versión de .NET 9. En la imagen siguiente se muestra la tabla de versión .NET 8 como referencia:

   La tabla de versiones de las notas de lanzamientos de GitHub para .NET

2. Seleccione el vínculo de la versión de .NET que descargó.

   En la sección anterior se usó .NET SDK 9.0.306, que se encuentra en la versión de .NET 9.0.10.

3. En la página de versión, puede ver la versión de .NET Runtime y .NET SDK y un vínculo al archivo de suma de comprobación. En la imagen siguiente se muestra la tabla de versión .NET 8 como referencia:

   

4. Haga clic con el botón derecho en el vínculo Suma de comprobación y cópielo al portapapeles.

5. Abre un terminal.

6. Use para descargar el archivo de suma de comprobación.

   Reemplace el vínculo del siguiente comando por el vínculo que ha copiado.

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

7. Con el archivo de suma de comprobación y el archivo de versión de .NET descargado en el mismo directorio, use el comando sha512sum -c {file} --ignore-missing para validar el archivo descargado.

   Cuando se supera la validación, verá que el archivo se imprime con el estado Aceptado:

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

   Si ve el archivo marcado como Fallado, el archivo que descargó no es válido y no debe usarse.

   $ 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
   

Establecimiento de variables de entorno en todo el sistema

Si ha usado el script de instalación anterior, las variables establecidas solo se aplican a la sesión de terminal actual. Agréguelas al perfil de shell. Hay muchos shells diferentes disponibles para Linux y cada uno tiene un perfil diferente. Por ejemplo:

• shell de Bash: ~/.bash_profile o ~/.bashrc
• Shell de Korn: ~/.kshrc or .profile
• Shell de Z: ~/.zshrc or .zprofile

Establezca las dos variables de entorno siguientes en el perfil de shell:

• DOTNET_ROOT

  Esta variable se establece en la carpeta donde se instaló .NET, como $HOME/.dotnet:

  export DOTNET_ROOT=$HOME/.dotnet
  

• PATH

  Esta variable debe incluir la carpeta y la carpeta :

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

Pasos siguientes

• Información general de la CLI de .NET
• Cómo habilitar la finalización de TAB para la CLI de .NET
• Tutorial: creación de una aplicación de consola con .NET