Partilhar via

Instale o .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 suportam o gerenciador de pacotes interno, consulte Instalar o .NET no Linux.

Instale o SDK (que inclui o tempo de execução) se quiser desenvolver aplicativos .NET. Ou, se você só precisar executar aplicativos, instale o Runtime. Se você estiver instalando o Runtime, sugerimos que instale o ASP.NET Core Runtime , pois ele inclui os tempos de execução .NET e ASP.NET Core.

Use os dotnet --list-sdks comandos 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.

Versões do .NET

Existem dois tipos de versões suportadas, Long Term Support (LTS) e Standard Term Support (STS). A qualidade de todos os lançamentos é a mesma. A única diferença é a duração do apoio. As versões LTS recebem suporte e patches gratuitos por três anos. As versões STS recebem suporte e patches gratuitos por dois anos. Para obter mais informações, consulte Política de suporte do .NET.

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

✔️ Suportado ❌ Sem apoio
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, quando você instala o .NET, dependências específicas não sejam instaladas, como quando você instala manualmente. A lista a seguir detalha as distribuições Linux que são suportadas pela Microsoft e têm dependências que você pode precisar instalar. Consulte a página de distribuição para obter mais informações:

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

Dependências 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 DEB

Se a sua distribuição não foi listada anteriormente e é baseada em debian, você pode precisar 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 automação e instalações não administrativas do SDK e do Runtime. Você pode baixar o script de https://dot.net/v1/dotnet-install.sh. Quando o .NET é instalado dessa forma, você deve instalar as dependências exigidas pela sua distribuição Linux. Use os links no artigo Instalar o .NET no Linux para sua distribuição Linux específica.

Importante

Bash é necessário para executar o script.

Você pode 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 este script, certifique-se de conceder permissão para que ele seja executado como um executável:

chmod +x ./dotnet-install.sh

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

./dotnet-install.sh --version latest

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

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

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

./dotnet-install.sh --channel 9.0

Para obter mais informações, consulte dotnet-install scripts reference.

Para habilitar o .NET na linha de comando, consulte Definir variáveis de ambiente em todo o sistema.

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

Instalação manual

Como alternativa aos gerenciadores de pacotes, você pode baixar e instalar manualmente o SDK e o tempo de execução. A instalação manual é comumente usada como parte de testes de integração contínua ou em uma distribuição Linux não suportada. Para um desenvolvedor ou usuário, é melhor usar um gerenciador de pacotes.

Baixe uma liberação binária para o SDK ou para o runtime de um dos seguintes sites. O SDK do .NET inclui o tempo de execução correspondente:

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

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

Exemplo

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

Importante

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

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 base identificado pela HOME variável ou ~ caminho:

export DOTNET_ROOT=$HOME/.dotnet

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

Verificar binários baixados

Depois de baixar um instalador ou uma versão binária, verifique-o para certificar-se de que o arquivo não foi alterado ou corrompido. Você pode verificar a soma de verificação no seu computador e, em seguida, compará-la com o que foi relatado no site de download.

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

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

Use o sha512sum comando 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.

Utilizar um ficheiro de checksum para validar

As notas de versão do .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 do .NET:

  1. 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 nessa seção vincula aos downloads e arquivos de soma de verificação para cada versão do .NET 9. A imagem a seguir mostra a tabela de lançamento do .NET 8 como referência:

    A tabela de versões das notas de lançamento do GitHub para .NET

  2. Selecione o link para a versão do .NET que você baixou.

    A seção anterior usava o .NET SDK 9.0.306, que está na versão .NET 9.0.10.

  3. Na página de versão, pode visualizar a versão do .NET Runtime e do .NET SDK, e um link para o arquivo de soma de verificação. A imagem a seguir mostra a tabela de lançamento do .NET 8 como referência:

    A tabela de download com somas de verificação para .NET

  4. Clique com o botão direito do mouse no link Checksum e copie para a área de transferência.

  5. Abra um terminal.

  6. Use curl -O {link} para baixar o arquivo de soma de verificação.

    Substitua o link no comando a seguir pelo link copiado.

    curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt

  7. Com o arquivo de soma de verificação e o arquivo de versão .NET baixados para o mesmo diretório, use o sha512sum -c {file} --ignore-missing comando 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 vir o ficheiro marcado como FALHOU, o ficheiro que transferiu não é válido e não deve ser utilizado.

    $ 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 apenas à sua sessão de terminal atual. Adicione-os ao seu perfil de shell. Existem muitos shells diferentes disponíveis para Linux e cada um tem um perfil diferente. 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 em seu perfil de shell:

  • DOTNET_ROOT

    Essa variável é definida como a pasta para a qual o .NET foi instalado, como $HOME/.dotnet:

    export DOTNET_ROOT=$HOME/.dotnet

  • PATH

    Esta variável deve incluir a DOTNET_ROOT pasta e a DOTNET_ROOT/tools pasta:

    export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools

Próximos passos

  • Last updated on