Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este artigo descreve como instalar .NET no Debian. Quando uma versão Debian deixa de ser suportada, o .NET deixa de ser suportado com essa versão. No entanto, estas instruções podem ajudar-te a pôr o .NET a funcionar nessas versões, mesmo que não seja suportado.
Instala o SDK (que inclui o tempo de execução) se quiseres desenvolver aplicações .NET. Ou, se você só precisar executar aplicativos, instale o Runtime. Se estiver a instalar o Runtime, sugerimos que instale o ASP.NET Core Runtime, pois inclui tanto o .NET Runtime como o ASP.NET Core.
Use os dotnet --list-sdks comandos e dotnet --list-runtimes para ver quais versões estão instaladas. Para mais informações, consulte Como verificar se o .NET já está instalado.
Distribuições suportadas
A tabela seguinte apresenta uma lista das versões .NET atualmente suportadas e das versões do Debian em que são suportadas. Estas versões permanecem suportadas até que a versão do .NET atinja o fim do suporte ou até que a versão do Debian chegue ao fim da vida útil.
| Debian | .NET |
|---|---|
| 13 | 10, 9, 8 |
| 12 | 10, 9, 8 |
As seguintes versões de .NET são ❌ já não suportadas:
- .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 de pré-visualização
As versões candidatas de pré-visualização e lançamento do .NET não estão disponíveis em repositórios de pacotes. Pode instalar pré-visualizações e lançar candidatos ao .NET de uma das seguintes formas:
Remover versões de pré-visualização
Ao usar um gestor de pacotes para gerir a instalação do .NET, pode deparar-se com um conflito se já tiver instalado uma versão de pré-visualização. O gestor de pacotes pode interpretar a versão não pré-visualizada como uma versão anterior do .NET. Para instalar a versão não prévia, primeiro desinstale as versões de visualização. Para mais informações sobre desinstalar .NET, veja Como remover o tempo de execução .NET e o SDK.
Debian 13
A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os seguintes comandos para adicionar a chave de assinatura de pacotes Microsoft à sua lista de chaves de confiança 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 só publica os pacotes x64 e Arm64 para .NET 10. Se precisares de instalar .NET noutras arquiteturas, como Arm32, não uses um gestor de pacotes com o feed de pacotes da Microsoft. Para mais informações sobre a instalação de .NET sem gestor de pacotes, consulte um dos seguintes artigos:
Instale o SDK
O SDK .NET permite-lhe desenvolver aplicações com .NET. Se instalares o SDK .NET, não precisas de instalar o runtime correspondente. Para instalar o SDK .NET, execute os seguintes comandos:
sudo apt-get update && \
sudo apt-get install -y dotnet-sdk-10.0
Para aprender a usar a CLI .NET, veja .NET CLI Overview.
Instalar o tempo de execução
O ASP.NET Core Runtime permite executar aplicações feitas com .NET que não forneceram o tempo de execução. Os comandos seguintes instalam o ASP.NET Core Runtime, que é o runtime mais compatível para .NET. No 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, podes instalar o .NET Runtime, que não inclui suporte ASP.NET Core: substituir aspnetcore-runtime-10.0 no comando anterior por dotnet-runtime-10.0:
sudo apt-get install -y dotnet-runtime-10.0
Para aprender a usar a CLI .NET, veja .NET CLI Overview.
Debian 12
A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os seguintes comandos para adicionar a chave de assinatura de pacotes Microsoft à sua lista de chaves de confiança 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 só publica os pacotes x64 e Arm64 para .NET 10. Se precisares de instalar .NET noutras arquiteturas, como Arm32, não uses um gestor de pacotes com o feed de pacotes da Microsoft. Para mais informações sobre a instalação de .NET sem gestor de pacotes, consulte um dos seguintes artigos:
Instale o SDK
O SDK .NET permite-lhe desenvolver aplicações com .NET. Se instalares o SDK .NET, não precisas de instalar o runtime correspondente. Para instalar o SDK .NET, execute os seguintes comandos:
sudo apt-get update && \
sudo apt-get install -y dotnet-sdk-10.0
Para aprender a usar a CLI .NET, veja .NET CLI Overview.
Instalar o tempo de execução
O ASP.NET Core Runtime permite executar aplicações feitas com .NET que não forneceram o tempo de execução. Os comandos seguintes instalam o ASP.NET Core Runtime, que é o runtime mais compatível para .NET. No 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, podes instalar o .NET Runtime, que não inclui suporte ASP.NET Core: substituir aspnetcore-runtime-10.0 no comando anterior por dotnet-runtime-10.0:
sudo apt-get install -y dotnet-runtime-10.0
Para aprender a usar a CLI .NET, veja .NET CLI Overview.
Usa o APT para atualizar o .NET
Quando uma nova atualização estiver disponível para .NET, pode atualizá-la através do APT com os seguintes comandos:
sudo apt-get update
sudo apt-get upgrade
Se atualizaste a tua distribuição Linux desde que instalaste o .NET, talvez tenhas de reconfigurar o repositório de pacotes da Microsoft. Execute as instruções de instalação da sua versão atual de distribuição para atualizar para o repositório de pacotes apropriado para atualizações .NET.
Resolução de Problemas
Esta secção fornece informações sobre erros comuns que pode ter ao usar APT para instalar .NET.
Não é possível encontrar o pacote
Importante
O feed de pacotes Microsoft publica pacotes para diferentes arquiteturas dependendo da versão .NET:
- .NET 10: apenas pacotes x64 e Arm64.
- .NET 9: apenas pacotes x64.
- .NET 8: pacotes apenas x64.
Se precisares de instalar .NET noutras arquiteturas, como Arm32, não uses um gestor de pacotes com o feed de pacotes da Microsoft. Para mais informações sobre a instalação de .NET sem gestor 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 é possível localizar o pacote {dotnet-package} ou Alguns pacotes não puderam ser instalados, execute os seguintes comandos.
Existem dois placeholders no seguinte conjunto de comandos.
{dotnet-package}
Isto representa o pacote .NET que estás a instalar, comoaspnetcore-runtime-8.0. Isso é usado no comando a seguirsudo apt-get install.
Primeiro, tente limpar a lista de pacotes:
sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update
Depois, tente instalar o .NET novamente. Se isso não funcionar, você pode 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 Debian mais antiga que 12, tente 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 ao buscar
Ao instalar o pacote .NET, pode ver um erro semelhante ao Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Este erro pode significar que o feed de pacotes para .NET está a ser atualizado com versões mais recentes dos pacotes, e que deves tentar novamente mais tarde. Durante uma atualização, o feed do pacote não deve ficar indisponível por mais de 30 minutos. Se você receber esse erro continuamente por mais de 30 minutos, registre um problema em https://github.com/dotnet/core/issues.
Dependências
Quando você instala com um gerenciador de pacotes, essas bibliotecas são instaladas para você. Mas, se instalar manualmente .NET ou publicar uma aplicação autónoma, terá de garantir que estas bibliotecas estão 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 notas
As dependências podem ser instaladas com o apt install comando. O trecho a seguir demonstra a instalação da libc6 biblioteca:
sudo apt install libc6
Próximos passos
Colabore connosco no GitHub
A origem deste conteúdo pode ser encontrada no GitHub, onde também pode criar e rever problemas e pedidos Pull. Para mais informações, consulte o nosso guia do contribuidor.
