Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se explica cómo se instala el SDK de .NET o el runtime de .NET en Linux, mediante el script de instalación o la extracción de archivos binarios. Para obtener una lista de las distribuciones que admiten el administrador de paquetes integrado, consulte Instalación de .NET en Linux.
Instale el SDK (que incluye el entorno de ejecución) si quiere 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 el entorno de ejecución de ASP.NET Core, ya que incluye los de .NET y ASP.NET Core.
Use los comandos dotnet --list-sdks y dotnet --list-runtimes para ver qué versiones están instaladas. Para obtener más información, vea Cómo comprobar que .NET Core 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 más información, consulte Directiva de soporte de .NET.
En la tabla siguiente se muestra el estado de compatibilidad de cada versión de .NET (y .NET Core):
| ✔️ Admitida | ❌ Fuera de soporte técnico |
|---|---|
| 10 (LTS) | 7 |
| 9 (STS) | 6 |
| 8 (LTS) | 5 |
| 3.1 | |
| 3.0 | |
| 2.2 | |
| 2.1 | |
| 2.0 | |
| 1.1 | |
| 1,0 |
Dependencias
Es posible que al instalar .NET, es posible que no se instalen dependencias específicas, como cuando se instala 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:
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 de https://dot.net/v1/dotnet-install.sh. Cuando .NET está instalado de esta manera, debe instalar las dependencias requeridas por la distribución de Linux. Use los vínculos que aparecen en el artículo Instalación de .NET en Linux para la distribución específica de Linux.
Importante
Se necesita Bash para ejecutar el script.
Puede descargar el script con wget:
wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
O bien, con curl:
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 como valor predeterminado instalar la versión más reciente del SDK de compatibilidad 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 --version latest.
./dotnet-install.sh --version latest
Para instalar el entorno de ejecución de .NET 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 --channel para indicar la versión deseada. El comando siguiente instala el SDK de .NET 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, vea Establecimiento de variables de entorno en todo el sistema.
Para obtener información sobre cómo usar la CLI de .NET, consulte Información general sobre la CLI de .NET.
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 runtime correspondiente:
- ✔️ Descargas de .NET 10
- ✔️ Descargas de .NET 9
- ✔️ Descargas de .NET 8
- 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, luego, 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, vea SDK de .NET 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 DOTNET_ROOT en el directorio de trabajo actual seguido de .dotnet. Ese directorio se crea si no existe. La variable de entorno DOTNET_FILE es el nombre de archivo de la versión binaria de .NET que desea instalar. Este archivo se extrae en el directorioDOTNET_ROOT. Tanto el directorio DOTNET_ROOT como su subdirectorio tools se agregan a la variable de entorno PATH.
Importante
Si ejecuta estos comandos, recuerde cambiar el valor de DOTNET_FILE al nombre del archivo binario de .NET que descargó.
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 principal identificado por la variable HOME o ruta de acceso~:
export DOTNET_ROOT=$HOME/.dotnet
Para obtener información sobre cómo usar la CLI de .NET, consulte Información general sobre la CLI de .NET.
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 sha512sum 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 contienen un enlace a un archivo de suma de comprobación que puedes usar para validar tu archivo descargado. En los pasos siguientes se describe cómo descargar el archivo de suma de comprobación y validar un binario de instalación de .NET:
La página de notas de la versión de .NET 9 en GitHub contiene https://github.com/dotnet/core/tree/main/release-notes/9.0#releases una sección denominada Lanzamientos. La tabla de esa sección está vinculada a los archivos de descargas y sumas de comprobación para cada versión de .NET 9. En la imagen siguiente se muestra la tabla de versión de .NET 8 como referencia:
Seleccione el vínculo de la versión de .NET que ha descargado.
En la sección anterior se usaba el SDK de .NET 9.0.306, que se encuentra en la versión de .NET 9.0.10.
En la página de versión, puede ver la versión del entorno de ejecución .NET y del SDK de .NET, y un enlace al archivo de suma de comprobación. En la imagen siguiente se muestra la tabla de versión de .NET 8 como referencia:
Haga clic con el botón derecho en el vínculo Suma de comprobación y cópielo al portapapeles.
Abre un terminal.
Use
curl -O {link}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.txtCon 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-missingpara 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: OKSi 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_ROOTEsta variable se establece en la carpeta en la que se instaló .NET, como
$HOME/.dotnet:export DOTNET_ROOT=$HOME/.dotnetPATHEsta variable debe incluir la carpeta
DOTNET_ROOTy la carpetaDOTNET_ROOT/tools:export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
Pasos siguientes
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
