Compartilhar via

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

Para simplificar, geralmente recomendamos usar o comando wsl --install para instalar o Subsistema do Windows para Linux. No entanto, se você estiver executando uma compilação mais antiga do Windows ou Windows Server Core, pode não ser compatível. Incluímos as etapas de instalação manuais abaixo. Se você encontrar um problema durante o processo de instalação, verifique a seção de instalação do guia de solução de problemas.

Etapa 1 – Habilitar o Subsistema do Windows para Linux

Primeiro, você deve habilitar o recurso opcional "Subsistema do Windows para Linux" antes de instalar as distribuições do Linux no Windows.

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

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

Agora, é recomendável passar para a etapa 2, atualizando para o WSL 2, mas se você quiser instalar apenas o WSL 1, agora poderá reiniciar o computador e passar para a Etapa 6 – Instalar sua distribuição do Linux de sua escolha. Para atualizar para o WSL 2, aguarde para reiniciar o computador e vá para a próxima etapa.

Etapa 2 – Verificar 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 o Build 18362.1049 ou posterior.
  • Para sistemas ARM64: versão 2004 ou posterior, com Build 19041 ou posterior.

ou Windows 11.

Observação

Builds inferiores a 18362 não dão suporte ao WSL 2. Use o Assistente do Windows Update para atualizar sua versão do Windows. O suporte do Windows versão 1903 também é apenas para sistemas x64. Se você estiver usando uma versão arm64 do Windows, precisará atualizar para o Windows 10 versão 2004 ou posterior para acesso completo ao WSL 2. Para obter mais informações, consulte o suporte do WSL 2 para versões do Windows 10 1903 e 1909.

Para verificar sua versão e o número de build, selecione a chave de logotipo do Windows + R, digite winver, selecione OK. Atualize 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 se há atualizações". O número de build deve ser 18362.1049+ ou 18363.1049+, com o número de build secundário acima de .1049. Leia mais: O suporte do WSL 2 está chegando ao Windows 10 versões 1903 e 1909.

Etapa 3 – Habilitar o recurso máquina virtual

Antes de instalar o WSL 2, você deve habilitar o recurso opcional da Plataforma de Máquina Virtual . Seu computador 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 seu computador para concluir a instalação e atualização do WSL para o WSL 2.

Etapa 4 – Baixar o pacote de atualização do kernel do Linux

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

  1. Baixe o pacote mais recente:

    Observação

    Se você estiver usando um computador ARM64, baixe o pacote ARM64 . Se você não tiver certeza de que tipo de computador você tem, abra o Prompt de Comando ou o PowerShell e insira: systeminfo | find "System Type". Advertência: Em versões não inglesas do Windows, talvez seja necessário modificar o texto de pesquisa, traduzindo a cadeia de caracteres "Tipo de Sistema". Talvez você também precise escapar das aspas para o comando localizar. Por exemplo, em alemão systeminfo | find '"Systemtyp"'.

  2. Execute o pacote de atualização baixado na etapa anterior. (Clique duas vezes para executar - você receberá uma solicitação de permissões com privilégios elevados, selecione 'sim' para aprovar esta instalação.)

Depois que a instalação for concluída, passe para a próxima etapa – definindo o WSL 2 como sua versão padrão ao instalar novas distribuições do 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 as alterações do artigo para atualizar o kernel do Linux WSL2, disponível no Blog de Linha de Comando do Windows.

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 do Linux:

wsl --set-default-version 2

Etapa 6 – Instalar sua distribuição de opções do Linux

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

    Exibição de distribuições do Linux na Microsoft Store

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

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

    Distribuições do Linux na Microsoft Store

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

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

Desempacotamento do Ubuntu no console do Windows

PARABÉNS! Você instalou e configurou com êxito uma distribuição do Linux totalmente integrada ao sistema operacional Windows!

Como solucionar problemas de instalação

Se você encontrar um problema durante o processo de instalação, verifique a seção de instalação do guia de solução de problemas.

Baixando distribuições de software

Há alguns cenários em que talvez você não possa (ou queira) instalar distribuições do WSL Linux usando a Microsoft Store. Você pode estar executando um SKU do sistema operacional da área de trabalho do Windows Server ou Long-Term (LTSC) que não dá 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 o WSL em si está disponível, talvez seja necessário baixar as distribuições do Linux diretamente.

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

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

Se preferir, você também pode baixar suas distribuições preferenciais 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 muito, desative 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 download. Para baixar o Ubuntu 20.04 com curl:

curl.exe -L -o ubuntu-2004.appx https://aka.ms/wslubuntu2004

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

Instalando o pacote Appx com Add-AppxPackage

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

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

Add-AppxPackage .\app_name.appx

Depois que o pacote Appx terminar de baixar, 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 Windows Server 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 alterando-o .appx para um arquivo zip.

Depois que a distribuição for instalada, siga as instruções para criar uma conta de usuário e senha para sua nova distribuição do 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 do 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 plano de fundo e atalhos de teclado personalizados. Saiba mais.

Instalar o Terminal do Windows.

Windows Terminal