Instalación del SDK de .NET o del entorno de ejecución de .NET en Debian

En este artículo se describe cómo instalar .NET en Debian. Cuando una versión de Debian deja de ser compatible, ya no se admite .NET con esa versión. Sin embargo, estas instrucciones pueden ayudarle a hacer que .NET funcione en esas versiones, aunque no sean compatibles.

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.

Distribuciones admitidas

En la tabla siguiente se muestra una lista de las versiones de .NET admitidas actualmente y las versiones de Debian en las que se admiten. Estas versiones siguen siendo compatibles hasta que la versión de .NET llega al final del soporte técnico o la versión de Debian alcanza el final de la vida.

Las siguientes versiones de .NET ya no se admiten ❌:

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

Instalación de versiones preliminares

Las versiones preliminares y versiones candidatas de lanzamiento de .NET no están disponibles en los repositorios de paquetes. Puede instalar versiones preliminares y candidatos de lanzamiento de .NET de una de las maneras siguientes:

• Instalación con scripts con install-dotnet.sh
• Extracción binaria manual

Eliminación de versiones preliminares

Al usar un administrador de paquetes para administrar la instalación de .NET, es posible que se produzca un conflicto si ha instalado previamente una versión preliminar. El administrador de paquetes puede interpretar la versión no preliminar como una versión anterior de .NET. Para instalar la versión que no es preliminar, desinstale primero las versiones preliminares. Para obtener más información sobre cómo desinstalar .NET, consulte Cómo quitar el entorno de ejecución y el SDK de .NET.

Debian 13

La instalación con APT puede realizarse con unos pocos comandos. Antes de instalar .NET, ejecute los siguientes comandos para agregar la clave de firma del paquete de Microsoft a la lista de claves de confianza y agregar el repositorio de paquetes.

Abra un terminal y ejecute los comandos siguientes:

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

La instalación con APT puede realizarse con unos pocos comandos. Antes de instalar .NET, ejecute los siguientes comandos para agregar la clave de firma del paquete de Microsoft a la lista de claves de confianza y agregar el repositorio de paquetes.

Abra un terminal y ejecute los comandos siguientes:

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

Uso de APT para actualizar .NET

Cuando hay disponible una nueva versión de revisión para .NET, puede actualizarla a través de APT con los siguientes comandos:

sudo apt-get update
sudo apt-get upgrade

Si actualizó la distribución de Linux desde la instalación de .NET, es posible que tenga que volver a configurar el repositorio de paquetes de Microsoft. Ejecute las instrucciones de instalación de la versión de distribución actual para actualizar al repositorio de paquetes adecuado para .NET actualizaciones.

Solución de problemas

En esta sección se proporciona información sobre los errores comunes que puede obtener al usar APT para instalar .NET.

No se puede encontrar el paquete

No se ha podido encontrar \ No se han podido instalar algunos paquetes

Si recibe un mensaje de error similar a No se puede encontrar el paquete {dotnet-package} o No se han podido instalar algunos paquetes, ejecute los comandos siguientes.

Hay dos marcadores de posición en el siguiente conjunto de comandos.

• {dotnet-package}
  Esto representa el paquete de .NET que va a instalar, como aspnetcore-runtime-8.0. Se usa en el comando siguiente.

Primero, pruebe a purgar la lista de paquetes:

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

A continuación, intente instalar .NET de nuevo. Si eso no funciona, puede ejecutar una instalación manual con los comandos siguientes:

Si usa Debian 12 o posterior, pruebe los siguientes comandos:

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

Si usa una versión de Debian anterior a 12, pruebe los siguientes comandos:

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

No se pudo capturar el elemento

Al instalar el paquete de .NET, es posible que vea un error similar a Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Este error podría significar que la fuente de paquetes para .NET se está actualizando con versiones de paquete más recientes y que debería intentarlo de nuevo más adelante. Durante una actualización, la fuente de paquetes no debería estar indisponible por más de 30 minutos. Si recibe este error continuamente durante más de 30 minutos, abra una incidencia en .

Dependencias

Al realizar la instalación con un administrador de paquetes, estas bibliotecas se instalan automáticamente. Sin embargo, si instala manualmente .NET o publica una aplicación independiente, deberá asegurarse de que estas bibliotecas están instaladas:

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

Otras notas

Las dependencias se pueden instalar con el comando . En el fragmento de código siguiente se muestra cómo instalar la biblioteca :

sudo apt install libc6

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