Compartilhar via

Instalar o SDK do .NET ou o runtime do .NET no Debian

Este artigo descreve como instalar .NET no Debian. Quando uma versão do Debian fica sem suporte, não há mais suporte para .NET com essa versão. No entanto, essas instruções podem ajudá-lo a obter .NET em execução nessas versões, mesmo que não tenha suporte.

Instale o SDK (que inclui o runtime) se você quiser desenvolver .NET aplicativos. Ou, se você precisar apenas executar aplicativos, instale o runtime. Se você estiver instalando o Runtime, sugerimos que instale o ASP.NET Core Runtime pois ele inclui runtimes .NET e ASP.NET Core.

Use os comandos e para ver quais versões estão instaladas. Para obter mais informações, consulte Como verificar se o .NET já está instalado.

Distribuições com suporte

A tabela a seguir é uma lista de versões .NET com suporte no momento e as versões do Debian em que elas têm suporte. Essas versões permanecem compatíveis até que a versão do .NET atinja o fim do suporte ou a versão do Debian atinja o fim da vida útil.

Debian .NET
13 10, 9, 8
12 10, 9, 8

As seguintes versões de .NET ❌ não têm mais suporte:

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

Instalar versões prévias

Versões de prévia e candidato a lançamento de .NET não estão disponíveis em repositórios de pacotes. Você pode instalar versões prévias e lançar candidatos de .NET de uma das seguintes maneiras:

  • Instalação por script com install-dotnet.sh
  • Extração binária manual

Remover versões prévias

Ao usar um gerenciador de pacotes para gerenciar a instalação de .NET, você poderá encontrar um conflito se já tiver instalado uma versão prévia. O gerenciador de pacotes pode interpretar a versão não prévia como uma versão anterior do .NET. Para instalar a versão que não é prévia, desinstale as versões prévias. Para obter mais informações sobre como desinstalar .NET, consulte How to remove the .NET Runtime and SDK.

Debian 13

A instalação com a APT pode ser feita com alguns comandos. Antes de instalar .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à sua lista de chaves confiáveis e adicionar o repositório de pacotes.

Abra um terminal e execute os seguintes comandos:

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

Importante

O feed de pacotes Microsoft publica apenas pacotes x64 e Arm64 para .NET 10. Se você precisar instalar .NET em outras arquiteturas, como Arm32, não use um gerenciador de pacotes com o feed de pacotes da Microsoft. Para obter mais informações sobre como instalar .NET sem um gerenciador de pacotes, consulte um dos seguintes artigos:

Instalar o SDK

O SDK do .NET permite que você desenvolva aplicativos com .NET. Se você instalar o SDK do .NET, não precisará instalar o runtime correspondente. Para instalar o SDK do .NET, execute os seguintes comandos:

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Instalar o runtime

O ASP.NET Core Runtime permite que você execute aplicativos que foram feitos com .NET que não forneceram o runtime. Os comandos a seguir instalam o ASP.NET Core Runtime, que é o runtime mais compatível para .NET. Em seu terminal, execute os seguintes comandos:

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

Como alternativa ao ASP.NET Core Runtime, você pode instalar o .NET Runtime, que não inclui ASP.NET Core suporte: substitua aspnetcore-runtime-10.0 no comando anterior por dotnet-runtime-10.0:

sudo apt-get install -y dotnet-runtime-10.0

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Debian 12

A instalação com a APT pode ser feita com alguns comandos. Antes de instalar .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à sua lista de chaves confiáveis e adicionar o repositório de pacotes.

Abra um terminal e execute os seguintes comandos:

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

Importante

O feed de pacotes Microsoft publica apenas pacotes x64 e Arm64 para .NET 10. Se você precisar instalar .NET em outras arquiteturas, como Arm32, não use um gerenciador de pacotes com o feed de pacotes da Microsoft. Para obter mais informações sobre como instalar .NET sem um gerenciador de pacotes, consulte um dos seguintes artigos:

Instalar o SDK

O SDK do .NET permite que você desenvolva aplicativos com .NET. Se você instalar o SDK do .NET, não precisará instalar o runtime correspondente. Para instalar o SDK do .NET, execute os seguintes comandos:

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Instalar o runtime

O ASP.NET Core Runtime permite que você execute aplicativos que foram feitos com .NET que não forneceram o runtime. Os comandos a seguir instalam o ASP.NET Core Runtime, que é o runtime mais compatível para .NET. Em seu terminal, execute os seguintes comandos:

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

Como alternativa ao ASP.NET Core Runtime, você pode instalar o .NET Runtime, que não inclui ASP.NET Core suporte: substitua aspnetcore-runtime-10.0 no comando anterior por dotnet-runtime-10.0:

sudo apt-get install -y dotnet-runtime-10.0

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Usar o APT para atualizar .NET

Quando uma nova versão de patch estiver disponível para .NET, você poderá atualizá-la por meio do APT com os seguintes comandos:

sudo apt-get update
sudo apt-get upgrade

Se você atualizou sua distribuição do Linux desde a instalação .NET, talvez seja necessário reconfigurar o repositório de pacotes da Microsoft. Execute as instruções de instalação da versão de distribuição atual para atualizar para o repositório de pacotes apropriado para atualizações .NET.

Solução de problemas

Esta seção fornece informações sobre erros comuns que você pode obter ao usar o APT para instalar .NET.

Não é possível localizar o pacote

Importante

O feed de pacotes Microsoft publica pacotes para arquiteturas diferentes, dependendo da versão .NET:

  • .NET 10: pacotes x64 e Arm64 apenas.
  • .NET 9: somente pacotes x64.
  • .NET 8: somente pacotes x64.

Se você precisar instalar .NET em outras arquiteturas, como Arm32, não use um gerenciador de pacotes com o feed de pacotes da Microsoft. Para obter mais informações sobre como instalar .NET sem um gerenciador de pacotes, consulte um dos seguintes artigos:

Não foi possível localizar\Alguns pacotes não puderam ser instalados

Se você receber uma mensagem de erro semelhante a Não foi possível localizar o pacote {dotnet-package} ou Alguns pacotes não puderam ser instalados, execute os comandos a seguir.

Existem dois placeholders no conjunto de comandos a seguir.

  • {dotnet-package}
    Isso representa o pacote .NET que você está instalando, como aspnetcore-runtime-8.0. Isso é usado no comando a seguir.

Primeiro, tente limpar a lista de pacotes:

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

Em seguida, tente instalar .NET novamente. Se isso não funcionar, você poderá executar uma instalação manual com os seguintes comandos:

Se você estiver usando o Debian 12 ou posterior, tente os seguintes 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}

Se você estiver usando uma versão do Debian com mais de 12 anos, experimente os seguintes 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}

Falha na busca

Ao instalar o pacote .NET, você poderá ver um erro semelhante a Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Esse erro pode significar que o feed de pacotes para .NET está sendo atualizado com versões de pacote mais recentes e que você deve tentar novamente mais tarde. Durante uma atualização, o feed de pacotes não deve ficar indisponível por mais de 30 minutos. Se você continuar recebendo esse erro por mais de 30 minutos, registre um problema em .

Dependências

Quando você faz a instalação com um gerenciador de pacotes, essas bibliotecas são instaladas automaticamente. Porém, se você instalar manualmente o .NET ou publicar um aplicativo autossuficiente, precisará garantir que essas bibliotecas estejam 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

Outras observações

As dependências podem ser instaladas usando o comando . O snippet a seguir demonstra a instalação da biblioteca :

sudo apt install libc6

Próximas etapas

  • Last updated on