Instalar .NET no Linux usando um script de instalação ou extraindo binários

Este artigo demonstra como instalar o SDK do .NET ou o .NET Runtime no Linux usando o script de instalação ou extraindo os binários. Para obter uma lista de distribuições que dão suporte ao gerenciador de pacotes interno, consulte Instalar .NET no Linux.

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 dotnet --list-sdks e dotnet --list-runtimes para ver quais versões estão instaladas. Para obter mais informações, consulte Como verificar se o .NET já está instalado.

.NET lançamentos

Há dois tipos de versões com suporte, LTS (Suporte a Longo Prazo) e STS (Suporte a Termos Padrão). A qualidade de todas as versões é a mesma. A única diferença é a duração do suporte. As versões lts recebem suporte gratuito e patches por três anos. As versões STS ganham suporte gratuito e patches por dois anos. Para obter mais informações, consulte .NET Support Policy.

A tabela a seguir lista o status de suporte de cada versão do .NET (e .NET Core):

✔️ Com suporte	❌ Sem suporte
10 (LTS)	7
9 (STS)	6
8 (LTS)	5
	3.1
	3,0
	2,2
	2.1
	2,0
	1,1
	1,0

Dependências

É possível que, ao instalar o .NET, dependências específicas possam não estar instaladas, como quando você faz uma instalação manual. A lista a seguir detalha as distribuições do Linux compatíveis com a Microsoft e que têm dependências que talvez seja necessário instalar. Verifique a página de distribuição para obter mais informações:

Para obter informações genéricas sobre as dependências, confira Aplicativos autônomos do Linux.

Dependências de RPM

Se sua distribuição não foi listada anteriormente e é baseada em RPM, talvez você precise das seguintes dependências:

glibc
libgcc
certificados CA
openssl-libs
libstdc++
libicu
tzdata
krb5-libs

Dependências de DEB

Se a distribuição não tiver sido listada anteriormente e for baseada em debian, talvez você precise das seguintes dependências:

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

Instalação com script

Os scripts dotnet-install são usados para instalações de automação e não administrativas do SDK e do Runtime. Você pode baixar o script de https://dot.net/v1/dotnet-install.sh. Quando .NET é instalado dessa forma, você deve instalar as dependências exigidas pela distribuição do Linux. Use os links no artigo Instalar .NET no Linux para sua distribuição específica do Linux.

Importante

O Bash é necessário para executar o script.

É possível baixar o script com wget:

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

Ou, com curl:

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

Antes de executar esse script, certifique-se de conceder permissão para que esse script seja executado como um executável:

chmod +x ./dotnet-install.sh

O script usa como padrão a instalação da versão mais recente do SDK long term support (LTS), que é .NET 10. Para instalar a versão mais recente, que pode não ser uma versão LTS, use o parâmetro --version latest.

./dotnet-install.sh --version latest

Para instalar .NET Runtime em vez do SDK, use o parâmetro --runtime.

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

Você pode instalar uma versão principal específica com o parâmetro --channel a fim de indicar a versão desejada. O comando a seguir instala .NET SDK do 9.0.

./dotnet-install.sh --channel 9.0

Para obter mais informações, confira a referência de scripts dotnet-install.

Para habilitar .NET na linha de comando, consulte Set environment variables system-wide.

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

Instalação manual

Como alternativa aos gerenciadores de pacotes, você pode baixar e instalar manualmente o SDK e o runtime. A instalação manual é usada com frequência como parte do teste de integração contínua ou em uma distribuição Linux sem suporte. Para desenvolvedores ou usuários, é melhor usar um gerenciador de pacotes.

Baixe uma versão binária do SDK ou do runtime em um dos sites a seguir. O SDK do .NET inclui o runtime correspondente:

Extraia o arquivo baixado e use o comando export para definir DOTNET_ROOT para o local da pasta extraída e verifique se .NET está no PATH. Exportar DOTNET_ROOT disponibiliza os comandos da CLI .NET no terminal. Para obter mais informações sobre variáveis de ambiente .NET, consulte .NET variáveis de ambiente do SDK e da CLI.

Diferentes versões de .NET podem ser extraídas para a mesma pasta, que coexistem lado a lado.

Exemplo

Os comandos a seguir usam o Bash para definir a variável de ambiente DOTNET_ROOT para o diretório de trabalho atual seguida de .dotnet. Se não existir, o diretório será criado. A variável de ambiente DOTNET_FILE é o nome do arquivo da versão binária .NET que você deseja instalar. Esse arquivo é extraído para o diretório DOTNET_ROOT. O diretório DOTNET_ROOT e seu subdiretório tools são adicionados à variável de ambiente PATH.

Importante

Se você executar esses comandos, lembre-se de alterar o valor DOTNET_FILE para o nome do binário .NET baixado.

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

Você pode instalar mais de uma versão do .NET na mesma pasta.

Você também pode instalar o .NET no diretório principal identificado pela variável HOME ou caminho ~.

export DOTNET_ROOT=$HOME/.dotnet

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

Verificar binários baixados

Depois de fazer o download de um instalador ou de uma versão binária, verifique se o arquivo não foi alterado ou corrompido. Você pode obter a soma de verificação no computador e depois compará-la com o que foi relatado no site de download.

Quando você baixa o arquivo de uma página oficial de download, a soma de verificação do arquivo é exibida em uma caixa de texto. Selecione o botão Copiar a fim de copiar o valor de soma de verificação para a área de transferência.

A página de download .NET com soma de verificação

Use o comando sha512sum para imprimir a soma de verificação do arquivo que você baixou. Por exemplo, o comando a seguir relata a soma de verificação do arquivo 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 a soma de verificação com o valor fornecido pelo site de download.

Usar um arquivo de soma de verificação para validar

As notas de versão .NET contêm um link para um arquivo de soma de verificação que você pode usar para validar o arquivo baixado. As etapas a seguir descrevem como baixar o arquivo de soma de verificação e validar um binário de instalação .NET:

A página de notas de versão do .NET 9 no GitHub em https://github.com/dotnet/core/tree/main/release-notes/9.0#releases contém uma seção chamada Releases. A tabela nesta seção contém links para os downloads e arquivos de soma de verificação de cada versão do .NET 9. A imagem a seguir mostra a tabela de lançamento do .NET 8 como referência:
Selecione o link para a versão do .NET que você baixou.

A seção anterior usou .NET SDK 9.0.306, que está na versão .NET 9.0.10.
Na página de versão, você pode ver o .NET Runtime e a versão do .NET SDK, e um link para o arquivo de checksum. A imagem a seguir mostra a tabela de lançamento do .NET 8 como referência:
Clique com o botão direito do mouse no link Checksum e copie-o para a área de transferência.
Abra um terminal.
Use curl -O {link} para baixar o arquivo de soma de verificação.

Substitua o link no comando a seguir pelo link que você copiou.
```
curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt
```
Com o arquivo de soma de verificação e o arquivo de versão .NET baixado no mesmo diretório, use o comando sha512sum -c {file} --ignore-missing para validar o arquivo baixado.

Quando a validação for aprovada, você verá o arquivo impresso com o status OK:
```
$ sha512sum -c 9.0.10-sha.txt --ignore-missing
dotnet-sdk-9.0.306-linux-x64.tar.gz: OK
```
Se você vir o arquivo marcado como COM FALHA, o arquivo baixado não será válido e não deverá ser usado.
```
$ 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
```

Definir variáveis de ambiente em todo o sistema

Se você usou o script de instalação anterior, as variáveis definidas se aplicam somente à sessão do terminal atual. Adicione-as ao perfil de shell. Há vários shells diferentes disponíveis para Linux, cada qual com um perfil distinto. Por exemplo:

Bash Shell: ~/.bash_profile ou ~/.bashrc
Korn Shell: ~/.kshrc ou .profile
Z Shell: ~/.zshrc ou .zprofile

Defina as duas variáveis de ambiente a seguir no perfil de shell:

DOTNET_ROOT

Essa variável é definida como a pasta na qual o .NET foi instalado, como $HOME/.dotnet:
```
export DOTNET_ROOT=$HOME/.dotnet
```
PATH

Essa variável deve incluir tanto a pasta DOTNET_ROOT quanto a pasta DOTNET_ROOT/tools:
```
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
```

Próximas etapas

Comentários

Esta página foi útil?

Last updated on 2026-03-12