Partilhar via

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

Este artigo demonstra como instalar o SDK .NET ou o Runtime .NET no Linux usando o script de instalação ou extraindo os binários. Para uma lista de distribuições que suportam o gestor de pacotes incorporado, veja Install .NET no Linux.

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.

Lançamentos .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 mais informações, consulte .NET Política de Apoio.

A tabela seguinte lista o estado 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, ao instalar .NET, dependências específicas não estejam instaladas, como quando 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. Pode descarregar o script de https://dot.net/v1/dotnet-install.sh. Quando o .NET é instalado por este método, deve instalar as dependências exigidas pela sua distribuição Linux. Use os links no artigo Install .NET on Linux para a 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 instala por defeito a 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 --version latest parâmetro.

./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 --channel parâmetro para indicar a versão específica. O comando seguinte instala o SDK .NET 9.0.

./dotnet-install.sh --channel 9.0

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

Para ativar .NET na linha de comandos, veja Set environment variables system-wide.

Para aprender a usar a CLI .NET, veja .NET CLI Overview.

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 .NET inclui o tempo de execução correspondente:

Extrair o ficheiro descarregado e usar o comando export para definir DOTNET_ROOT na localização da pasta extraída e depois garantir que .NET está em PATH. Exportar DOTNET_ROOT torna os comandos CLI .NET disponíveis no terminal. Para mais informações sobre .NET variáveis de ambiente, veja .NET SDK e variáveis de ambiente 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 variável de ambiente DOTNET_FILE é o nome do ficheiro da versão binária .NET que pretende 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 executares estes comandos, lembra-te de mudar o valor DOTNET_FILE pelo nome do binário .NET que descarregaste.

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

Podes instalar mais do que uma versão do .NET na mesma pasta.

Também pode instalar .NET no diretório doméstico identificado pela variável HOME ou pelo caminho ~:

export DOTNET_ROOT=$HOME/.dotnet

Para aprender a usar a CLI .NET, veja .NET CLI Overview.

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 checksum

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 lançamento do .NET contêm um link para um ficheiro de soma de verificação que pode usar para validar o ficheiro descarregado. Os passos seguintes descrevem como descarregar o ficheiro de soma de verificação e validar um binário de instalação .NET:

  1. A página de notas de lançamento para .NET 9 em GitHub em https://github.com/dotnet/core/tree/main/release-notes/9.0#releases contém uma secção chamada Releases. A tabela nessa secção contém ligações para os ficheiros de download e de soma de verificação de cada versão do .NET 9. A imagem seguinte mostra a tabela de lançamentos do .NET 8 como referência:

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

  2. Selecione o link da versão do .NET que descarregou.

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

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

    A tabela de downloads 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 tanto o ficheiro de verificação como o ficheiro de .NET release descarregados para o mesmo diretório, use o comando sha512sum -c {file} --ignore-missing para validar o ficheiro descarregado.

    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

    Esta variável é definida para a pasta em que 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