Partilhar via

Etapas de instalação manual para versões mais antigas do WSL

Para simplificar, geralmente recomendamos usar o wsl --install para instalar o Subsistema Windows para Linux, mas se estiveres a executar uma compilação mais antiga do Windows ou Windows Server Core, isso pode não ser suportado. Incluímos as etapas de instalação manual abaixo. Se tiveres um problema durante o processo de instalação, verifica a secção de instalação do guia de solução de problemas.

Etapa 1 - Habilitar o subsistema Windows para Linux

Você deve primeiro ativar o recurso opcional "Subsistema Windows para Linux" antes de instalar qualquer distribuição Linux no Windows.

Abra o PowerShell como Administrador (menu Iniciar > PowerShell > clique com o botão direito do mouse > Executar como Administrador) e digite este comando:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

Recomendamos agora passar para a Etapa 2 - Verifique os requisitos para executar o WSL 2, atualizando para o WSL 2, mas se você deseja instalar apenas o WSL 1, agora você pode reiniciar sua máquina e passar para o Passo 6 - Instalar sua distribuição Linux de escolha. Para atualizar para o WSL 2, aguarde o reinício da sua máquina e siga para o próximo passo.

Etapa 2 - Verifique os requisitos para executar o WSL 2

Para atualizar para o WSL 2, você deve estar executando o Windows 10...

  • Para sistemas x64: Versão 1903 ou posterior, com Build 18362.1049 ou posterior.
  • Para sistemas ARM64: Versão 2004 ou posterior, com Build 19041 ou posterior.

ou Windows 11.

Observação

As versões inferiores a 18362 não suportam o WSL 2. Utilize o Assistente do Windows Update para atualizar a sua versão do Windows. O suporte para Windows versão 1903 também é apenas para sistemas x64. Se estiver a utilizar uma versão Arm64 do Windows, terá de atualizar para o Windows 10 versão 2004 ou posterior para obter acesso total ao WSL 2. Para obter mais informações, consulte suporte ao WSL 2 que será disponibilizado no Windows 10 versões 1903 e 1909.

Para verificar sua versão e número de compilação, selecione tecla do logotipo do Windows + R, digite winver, selecione OK. Atualizar para a versão mais recente do Windows no menu Configurações.

Observação

Se você estiver executando o Windows 10 versão 1903 ou 1909, abra "Configurações" no menu do Windows, navegue até "Atualizar & segurança" e selecione "Verificar atualizações". O seu número de build deve ser 18362.1049+ ou 18363.1049+, com o número de build secundário acima de .1049. Leia mais: suporte WSL 2 está chegando ao Windows 10 versões 1903 e 1909.

Etapa 3 - Habilitar o recurso de máquina virtual

Antes de instalar o WSL 2, você deve habilitar o Virtual Machine Platform recurso opcional. Sua máquina exigirá recursos de virtualização para usar esse recurso.

Abra o PowerShell como Administrador e execute:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Reinicie sua máquina para concluir a instalação do WSL e atualizar para o WSL 2.

Etapa 4 - Baixe o pacote de atualização do kernel Linux

O pacote de atualização do kernel Linux instala a versão mais recente do kernel Linux WSL 2 para executar o WSL dentro da imagem do sistema operativo Windows. (Para executar WSL a partir da Microsoft Store, com atualizações por push mais frequentes, use wsl.exe --install ou wsl.exe --update.).

  1. Faça o download do pacote mais recente:

    Observação

    Se você não conhece a arquitetura do seu sistema, pressione as Win + X teclas, encontre Sistema no menu ou pressione a Y tecla para abrir as configurações "Sobre o sistema" (ou Painel de Controle) interface e encontrar a arquitetura do seu sistema atual.

  2. Execute o pacote de atualização baixado na etapa anterior. (Clique duas vezes para executar - você será solicitado a fornecer permissões elevadas, selecione 'sim' para aprovar esta instalação.)

Quando a instalação estiver concluída, passe para a próxima etapa - definir o WSL 2 como sua versão padrão ao instalar novas distribuições Linux. (Ignore esta etapa se quiser que suas novas instalações do Linux sejam definidas como WSL 1).

Observação

Para obter mais informações, leia o artigo alterações na atualização do kernel Linux WSL2, disponível no Windows Command Line Blog.

Etapa 5 - Definir o WSL 2 como sua versão padrão

Abra o PowerShell e execute este comando para definir o WSL 2 como a versão padrão ao instalar uma nova distribuição Linux:

wsl --set-default-version 2

Passo 6 - Instale a sua distribuição Linux de escolha

  1. Abra o Microsoft Store e selecione sua distribuição Linux favorita.

    Vista de distribuições Linux na Microsoft Store

    Os links a seguir abrirão a página da Microsoft Store para cada distribuição:

    *Pago apenas indica que é pago na Microsoft Store, mas isso não significa que não tenha outros canais de download gratuito.

  2. Na página da distribuição, selecione "Obter".

    distribuições Linux na loja da Microsoft

Na primeira vez que você iniciar uma distribuição Linux recém-instalada, uma janela do console será aberta e você será solicitado a esperar por um minuto ou dois para que os arquivos sejam descompactados e armazenados no seu PC. Todos os lançamentos futuros devem levar menos de um segundo.

Em seguida, você precisará criar uma conta de usuário e senha para sua nova distribuição Linux.

descompactação do Ubuntu no console do Windows

PARABÉNS;! Você instalou e configurou com sucesso uma distribuição Linux que é completamente integrada com o seu sistema operacional Windows!

Solução de problemas de instalação

Se tiveres um problema durante o processo de instalação, verifica a secção de instalação do guia de solução de problemas.

Download de distribuições

Existem alguns cenários em que você pode não ser capaz (ou querer) instalar distribuições WSL Linux usando a Microsoft Store. Você pode estar executando uma SKU do sistema operacional de desktop Windows Server ou Long-Term LTSC (LTSC) que não oferece suporte à Microsoft Store ou suas políticas de rede corporativa e/ou administradores não permitem o uso da Microsoft Store em seu ambiente. Nesses casos, enquanto a própria WSL estiver disponível, talvez seja necessário baixar distribuições Linux diretamente.

Se o aplicativo da Microsoft Store não estiver disponível, você poderá baixar e instalar manualmente distribuições Linux usando estes links:

Isso fará com que os pacotes <distro>.appx sejam baixados para uma pasta de sua escolha.

Se preferir, você também pode baixar sua(s) distribuição(ões) preferida(s) por meio da linha de comando, pode usar o PowerShell com o cmdlet Invoke-WebRequest. Por exemplo, para baixar o Ubuntu 20.04:

Invoke-WebRequest -Uri https://aka.ms/wslubuntu2004 -OutFile Ubuntu.appx -UseBasicParsing

Dica

Se o download estiver demorando, desligue a barra de progresso definindo $ProgressPreference = 'SilentlyContinue'

Você também tem a opção de usar o utilitário de linha de comando curl para fazer o download. Para baixar o Ubuntu 20.04 com curl:

curl.exe -LR -o ubuntu-2004.Appx https://aka.ms/wslubuntu2204

Neste exemplo, curl.exe é executado (não apenas curl) para garantir que, no PowerShell, o executável curl real seja invocado, não o alias curl do PowerShell para Invoke-WebRequest.

Instalando o pacote Appx com o Add-AppxPackage

Observação O comando a seguir não funcionará em instalações Server Core:

Uma vez que a distribuição tenha sido baixada, navegue até a pasta que contém o download e execute o seguinte comando nesse diretório, onde app-name é o nome do arquivo de .appx de distribuição do Linux.

Add-AppxPackage .\app_name.Appx

Assim que o download do pacote Appx terminar, você poderá começar a executar a nova distribuição clicando duas vezes no arquivo appx. (O comando wsl -l não mostrará que a distribuição está instalada até que esta etapa seja concluída).

Se você estiver usando o servidor Windows ou tiver problemas ao executar o comando acima, poderá encontrar as instruções de instalação alternativas na página de documentação do Windows Server para instalar o arquivo .Appx alterando-o para um arquivo zip.

Depois que sua distribuição estiver instalada, siga as instruções para criar uma conta de usuário e senha para sua nova distribuição Linux.

Instalar o Terminal do Windows (opcional)

O uso do Terminal do Windows permite que você abra várias guias ou painéis de janela para exibir e alternar rapidamente entre várias distribuições Linux ou outras linhas de comando (PowerShell, Prompt de Comando, CLI do Azure, etc.). Você pode personalizar totalmente seu terminal com esquemas de cores exclusivos, estilos de fonte, tamanhos, imagens de fundo e atalhos de teclado personalizados. Saiba mais.Terminal do Windows

Instalar o Windows Terminal

  • Last updated on