Partilhar via

Instale o SDK .NET ou o runtime .NET no Alpine

.NET é suportado no Alpine e este artigo descreve como instalar o .NET no Alpine. Quando uma versão Alpine deixa de ser suportada, o .NET deixa de ser suportado com essa versão.

Se estiver a usar Docker, considere usar as imagens .NET Docker oficiais em vez de instalar o .NET você mesmo.

Importante

.NET 10 foi lançado a 11 de novembro de 2025. Pode levar algum tempo para que os pacotes apareçam nos feeds do gerenciador de pacotes ou para que sua distribuição Linux específica o inclua.

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 é uma lista das versões .NET atualmente suportadas e das versões do Alpine 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 Alpine chegue ao fim da vida útil.

Alpino Versão Suportada Disponível no Package Manager
3.23 10, 9, 8 10, 9, 8
3.22 10, 9, 8 9, 8
3.21 9, 8 9, 8
3.20 9, 8 8, 6

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

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 o seguinte comando:

sudo apk add dotnet10-sdk

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. O comando seguinte instala o ASP.NET Core Runtime, que é o runtime mais compatível para .NET. No seu terminal, execute o seguinte comando:

sudo apk add aspnetcore10-runtime

Como alternativa ao ASP.NET Core Runtime, podes instalar o .NET Runtime, que não inclui suporte ASP.NET Core: substituir aspnetcore10-runtime no comando anterior por dotnet10-runtime:

sudo apk add dotnet10-runtime

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

Arquiteturas suportadas

A tabela seguinte apresenta uma lista das versões .NET atualmente suportadas e da arquitetura do Alpine onde são suportadas. Estas versões permanecem suportadas até que a versão do .NET atinja o fim do suporte ou até que a arquitetura do Alpine seja suportada#. Note que apenas x86_64, armv7, aarch64 é oficialmente suportado pela Microsoft. Outras arquiteturas são suportadas pelos mantenedores de distribuição e podem ser instaladas usando o gerenciador de pacotes apk, se um pacote estiver disponível para essa arquitetura.

Arquitetura .NET 10 .NET 9 .NET 8
x86_64 3.22 3.20, 3.21, 3.22 3.20, 3.21, 3.22
x86 Nenhuma Nenhuma Nenhuma
AARCH64 3.22 3.20, 3.21, 3.22 3.20, 3.21, 3.22
ARMv7 3.22 3.20, 3.21, 3.22 3.20, 3.21, 3.22
ARMHF Nenhuma Nenhuma Nenhuma
S390X Nenhuma Nenhuma Nenhuma
ppc64le Nenhuma Nenhuma Nenhuma
RISCV64 Nenhuma Nenhuma Nenhuma

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.

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:

3.20+

  • Certificados CA
  • libgcc
  • libssl3
  • libstdc++
  • zlib (apenas .NET 8)
  • icu-libs e icu-data-full (a menos que a aplicação .NET esteja a correr em modo de globalização invariante)
  • tzdata
  • KRB5

Use o apk add comando para instalar as dependências.

Próximos passos

  • Last updated on