Guia de instalação do Subsistema Windows para Linux para Windows 10Windows Subsystem for Linux Installation Guide for Windows 10

Instalar o Subsistema do Windows para LinuxInstall Windows Subsystem for Linux

O Subsistema do Windows para Linux tem duas versões diferentes que podem ser escolhidas durante o processo de instalação.Windows Subsystem for Linux has two different versions to choose between during the installation process. O WSL 2 tem melhor desempenho geral e é recomendável usá-lo.WSL 2 has better overall performance and we recommend using it. Se o seu sistema não der suporte ao WSL 2 ou se você tiver uma situação específica que exija o armazenamento de arquivos entre sistemas, talvez você queira continuar com o WSL 1.If your system does not support WSL 2, or you have a specific situation that requires cross-system file storage, then you may want to stick with WSL 1. Leia mais sobre a Comparação entre o WSL 2 e o WSL 1.Read more about Comparing WSL 2 and WSL 1.

Etapa 1 – Habilitar o Subsistema do Windows para LinuxStep 1 - Enable the Windows Subsystem for Linux

Antes de instalar qualquer distribuição do Linux no Windows, você precisará primeiro habilitar o recurso opcional "Subsistema do Windows para Linux".You must first enable the "Windows Subsystem for Linux" optional feature before installing any Linux distributions on Windows.

Abra o PowerShell como administrador e execute:Open PowerShell as Administrator and run:

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

Agora, é recomendável passar para a etapa 2, de atualização para o WSL 2. Mas, se você desejar instalar apenas o WSL 1, será possível reiniciar o computador e passar para a Etapa 6 – Instalar a distribuição do Linux de sua escolha.We recommend now moving on to step #2, updating to WSL 2, but if you wish to only install WSL 1, you can now restart your machine and move on to Step 6 - Install your Linux distribution of choice. Para atualizar para o WSL 2, aguarde o seu computador ser reiniciado e passe para a próxima etapa.To update to WSL 2, wait to restart your machine and move on to the next step.

Etapa 2 – Atualizar para o WSL 2Step 2 - Update to WSL 2

Para atualizar para o WSL 2, você precisa estar executando o Windows 10.To update to WSL 2, you must be running Windows 10.

RequisitosRequirements

  • Para sistemas x64: Versão 1903 ou superiores, com o Build 18362 ou superiores.For x64 systems: Version 1903 or higher, with Build 18362 or higher.
  • Para sistemas ARM64: Versão 2004 ou superiores, com o Build 19041 ou superiores.For ARM64 systems: Version 2004 or higher, with Build 19041 or higher.
  • Os builds inferiores a 18362 não dão suporte a WSL 2.Builds lower than 18362 do not support WSL 2. Use o Assistente do Windows Update para atualizar a sua versão do Windows.Use the Windows Update Assistant to update your version of Windows.

Para verificar a sua versão e o número de build, selecione a tecla do logotipo do Windows + R , digite winver e selecione OK .To check your version and build number, select Windows logo key + R , type winver , select OK . (Ou digite o comando ver no prompt de comando do Windows).(Or enter the ver command in Windows Command Prompt). Atualize para a versão mais recente do Windows no menu Configurações.Update to the latest Windows version in the Settings menu.

Observação

Se você estiver executando o Windows 10 versão 1903 ou 1909, abra "Configurações" no menu do Windows, navegue até "Atualizações e Segurança" e selecione "Verificar Atualizações".If you are running Windows 10 version 1903 or 1909, open "Settings" from your Windows menu, navigate to "Update & Security" and select "Check for Updates". O número de Build precisa ser 18362.1049+ ou 18363.1049+ e o nº do build secundário deve ser maior que .1049.Your Build number must be 18362.1049+ or 18363.1049+, with the minor build # over .1049. Leia mais: O suporte a WSL 2 estará disponível em breve nas Versões 1903 e 1909 do Windows 10.Read more: WSL 2 Support is coming to Windows 10 Versions 1903 and 1909. Confira as instruções de solução de problemas.See the troubleshooting instructions.

Etapa 3 – Habilitar o recurso de Máquina VirtualStep 3 - Enable Virtual Machine feature

Antes de instalar o WSL 2, você precisa habilitar o recurso opcional Plataforma de Máquina Virtual .Before installing WSL 2, you must enable the Virtual Machine Platform optional feature.

Abra o PowerShell como administrador e execute:Open PowerShell as Administrator and run:

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

Reinicie o computador para concluir a instalação do WSL e a atualização para o WSL 2.Restart your machine to complete the WSL install and update to WSL 2.

Etapa 4 – Baixar o pacote de atualização do kernel do LinuxStep 4 - Download the Linux kernel update package

  1. Baixar o pacote mais recente:Download the latest package:

    Observação

    Se estiver usando um computador ARM64, baixe o pacote ARM64.If you're using an ARM64 machine, please download the ARM64 package instead. Se você não tiver certeza do tipo do seu computador, abra o Prompt de Comando ou o PowerShell e insira: systeminfo | find "System Type".If you're not sure what kind of machine you have, open Command Prompt or PowerShell and enter: systeminfo | find "System Type".

  2. Execute o pacote de atualização baixado na etapa anterior.Run the update package downloaded in the previous step. (Clique duas vezes para executar. Você receberá uma solicitação para fornecer permissões elevadas; selecione 'sim' para aprovar essa instalação.)(Double-click to run - you will be prompted for elevated permissions, select ‘yes’ to approve this installation.)

Depois que a instalação for concluída, vá para a próxima etapa: configurar o WSL 2 como a sua versão padrão ao instalar novas distribuições do LinuxOnce the installation is complete, move on to the next step - setting WSL 2 as your default version when installing new Linux distributions. (ignore essa etapa se você quiser que as novas instalações do Linux sejam definidas como WSL 1).(Skip this step if you want your new Linux installs to be set to WSL 1).

Observação

Para obter mais informações, leia o artigo Alterações na atualização do kernel do Linux para o WSL 2, disponível no blog da linha de comando do Windows.For more information, read the article changes to updating the WSL2 Linux kernel, available on the Windows Command Line Blog.

Etapa 5 – Definir o WSL 2 como a sua versão padrãoStep 5 - Set WSL 2 as your default version

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:Open PowerShell and run this command to set WSL 2 as the default version when installing a new Linux distribution:

wsl --set-default-version 2

Observação

A atualização da WSL 1 para a WSL 2 pode levar vários minutos para ser concluída, dependendo do tamanho da sua distribuição alvo.The update from WSL 1 to WSL 2 may take several minutes to complete depending on the size of your targeted distribution. Se você estiver executando uma instalação mais antiga (herdada) do WSL 1 da Atualização para Criadores ou da Atualização de Aniversário do Windows 10, poderá encontrar um erro de atualização.If you are running an older (legacy) installation of WSL 1 from Windows 10 Anniversary Update or Creators Update, you may encounter an update error. Siga estas instruções para desinstalar e remover as distribuições herdadas.Follow these instructions to uninstall and remove any legacy distributions.

Se wsl --set-default-version resultar como um comando inválido, insira wsl --help.If wsl --set-default-version results as an invalid command, enter wsl --help. Se --set-default-version não estiver listado, isso significa que o sistema operacional não é compatível com ele, e você precisará atualizá-lo para a versão 1903, Build 18362 ou superior.If the --set-default-version is not listed, it means that your OS doesn't support it and you need to update to version 1903, Build 18362 or higher.

Você verá esta mensagem depois de executar o comando: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel.If you see this message after running the command: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel. Você ainda precisa instalar o pacote de atualização MSI do kernel do Linux.You still need to install the MSI Linux kernel update package.

Etapa 6 – Instalar a distribuição do Linux de sua escolhaStep 6 - Install your Linux distribution of choice

  1. Abra a Microsoft Store e escolha sua distribuição do Linux favorita.Open the Microsoft Store and select your favorite Linux distribution.

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

    Os links a seguir abrirão a página da Microsoft Store para cada distribuição:The following links will open the Microsoft store page for each distribution:

  2. Na página da distribuição, selecione "Obter".From the distribution's page, select "Get".

    Distribuições do Linux na Microsoft Store

Etapa 7 – Configurar uma nova distribuiçãoStep 7 - Set up a new distribution

Na primeira vez que você iniciar uma distribuição do Linux recém-instalada, uma janela de console será aberta e será solicitado que você aguarde um ou dois minutos para que os arquivos sejam descompactados e armazenados em seu PC.The first time you launch a newly installed Linux distribution, a console window will open and you'll be asked to wait for a minute or two for files to de-compress and be stored on your PC. Todas as futuras inicializações deverão levar menos de um segundo.All future launches should take less than a second.

Em seguida, você precisará criar uma conta de usuário e uma senha para sua nova distribuição do Linux.You will then need to create a user account and password for your new Linux distribution.

Desempacotamento do Ubuntu no console do Windows

PARABÉNS! Você instalou e configurou com êxito uma distribuição do Linux totalmente integrada ao seu sistema operacional Windows.CONGRATULATIONS! You've successfully installed and set up a Linux distribution that is completely integrated with your Windows operating system!

Instalar o Terminal do Windows (opcional)Install Windows Terminal (optional)

O Terminal do Windows permite habilitar várias guias (para alternar rapidamente entre as linhas de comando do Linux, o Prompt de Comando do Windows, o PowerShell, a CLI do Azure etc.), criar associações de chave personalizadas (teclas de atalho para abrir ou fechar guias, copiar e colar etc.), usar o recurso de pesquisa e configurar temas personalizados (esquemas de cores, estilos e tamanhos de fonte, imagem de tela de fundo/desfoque/transparência).Windows Terminal enables multiple tabs (quickly switch between multiple Linux command lines, Windows Command Prompt, PowerShell, Azure CLI, etc), create custom key bindings (shortcut keys for opening or closing tabs, copy+paste, etc.), use the search feature, and custom themes (color schemes, font styles and sizes, background image/blur/transparency). Saiba mais.Learn more.

Instalar o Terminal do Windows.Install Windows Terminal.

Terminal do Windows

Definir a versão de distribuição para WSL 1 ou WSL 2Set your distribution version to WSL 1 or WSL 2

Verifique a versão do WSL atribuída a cada uma das distribuições do Linux instaladas abrindo a linha de comando do PowerShell e inserindo o comando (disponível somente no Windows Build 18362 ou superior): wsl -l -vYou can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in Windows Build 18362 or higher): wsl -l -v

wsl --list --verbose

Para definir uma distribuição para ter suporte de qualquer versão do WSL, execute:To set a distribution to be backed by either version of WSL please run:

wsl --set-version <distribution name> <versionNumber>

Assegure-se de substituir <distribution name> pelo nome real da sua distribuição e <versionNumber> pelo número '1' ou '2'.Make sure to replace <distribution name> with the actual name of your distribution and <versionNumber> with the number '1' or '2'. Você pode retornar ao WSL 1 a qualquer momento executando o mesmo comando acima, mas substituindo “2” por “1”.You can change back to WSL 1 at anytime by running the same command as above but replacing the '2' with a '1'.

Além disso, se quiser tornar o WSL 2 sua arquitetura padrão, você poderá fazê-lo com este comando:Additionally, if you want to make WSL 2 your default architecture you can do so with this command:

wsl --set-default-version 2

Isso definirá a versão de qualquer nova distribuição instalada no WSL 2.This will set the version of any new distribution installed to WSL 2.

Como solucionar problemas de instalaçãoTroubleshooting installation

Veja abaixo erros relacionados e correções sugeridas.Below are related errors and suggested fixes. Consulte a página de solução de problemas do WSL para ver outros erros comuns e suas soluções.Refer to the WSL troubleshooting page for other common errors and their solutions.

  • Falha na instalação com o erro 0x80070003Installation failed with error 0x80070003

    • O Subsistema Windows para Linux é executado somente na unidade do sistema (normalmente, a unidade C:).The Windows Subsystem for Linux only runs on your system drive (usually this is your C: drive). Verifique se as distribuições estão armazenadas na unidade do sistema:Make sure that distributions are stored on your system drive:
    • Abra Configurações -> **Sistema –> Armazenamento -> Mais Configurações de Armazenamento: Altere onde o novo conteúdo é salvo Imagem das configurações do sistema para instalar aplicativos na unidade C:Open Settings -> **System --> Storage -> More Storage Settings: Change where new content is saved Picture of system settings to install apps on C: drive
  • WslRegisterDistribution falhou com o erro 0x8007019eWslRegisterDistribution failed with error 0x8007019e

    • O componente opcional do Subsistema Windows para Linux não está habilitado:The Windows Subsystem for Linux optional component is not enabled:
    • Abra Painel de Controle -> Programas e Recursos -> Ativar ou Desativar Recursos do Windows -> Selecione Subsistema do Windows para Linux ou use o cmdlet PowerShell mencionado no início deste artigo.Open Control Panel -> Programs and Features -> Turn Windows Feature on or off -> Check Windows Subsystem for Linux or using the PowerShell cmdlet mentioned at the beginning of this article.
  • Ocorreu falha na instalação com o erro 0x80070003 ou 0x80370102Installation failed with error 0x80070003 or error 0x80370102

    • Verifique se a virtualização está habilitada dentro do BIOS do seu computador.Please make sure that virtualization is enabled inside of your computer's BIOS. As instruções para fazer isso variam de um computador para o outro e muito provavelmente estarão sob opções relacionadas à CPU.The instructions on how to do this will vary from computer to computer, and will most likely be under CPU related options.
  • Erro ao tentar fazer upgrade: Invalid command line option: wsl --set-version Ubuntu 2Error when trying to upgrade: Invalid command line option: wsl --set-version Ubuntu 2

    • Verifique se você tem o Subsistema do Windows para Linux habilitado e se está usando o Windows versão do Build 18362 ou superior.Enure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 18362 or higher. Para habilitar o WSL, execute este comando em um prompt do PowerShell com privilégios de administrador: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux.To enable WSL run this command in a PowerShell prompt with admin privileges: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux.
  • A operação solicitada não pôde ser concluída devido a uma limitação do sistema de disco virtual. Os arquivos do disco rígido virtual devem ser descompactados e descriptografados e não devem ser esparsos.The requested operation could not be completed due to a virtual disk system limitation. Virtual hard disk files must be uncompressed and unencrypted and must not be sparse.

    • Desmarque "Compactar conteúdo" (bem como "Criptografar conteúdo", se estiver marcado) abrindo a pasta de perfil da sua distribuição do Linux.Deselect “Compress contents” (as well as “Encrypt contents” if that’s checked) by opening the profile folder for your Linux distribution. Ela deve estar localizada em uma pasta no sistema de arquivos do Windows, algo como: USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited...It should be located in a folder on your Windows file system, something like: USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited...
    • Nesse perfil de distribuição do Linux, deve haver uma pasta LocalState.In this Linux distro profile, there should be a LocalState folder. Clique com o botão direito do mouse nessa pasta para exibir um menu de opções.Right-click this folder to display a menu of options. Selecione Propriedades > Avançado e, em seguida, verifique se as caixas de seleção "Compactar conteúdo para economizar espaço em disco" e "Criptografar conteúdo para proteger dados" estão desmarcadas (não selecionadas).Select Properties > Advanced and then ensure that the “Compress contents to save disk space” and “Encrypt contents to secure data” checkboxes are unselected (not checked). Se for solicitado que você aplique isso apenas à pasta atual ou a todas as subpastas e arquivos, selecione "somente esta pasta" porque você só vai limpar o sinalizador de compactação.If you are asked whether to apply this to just to the current folder or to all subfolders and files, select “just this folder” because you are only clearing the compress flag. Depois disso, o comando wsl --set-version deve funcionar.After this, the wsl --set-version command should work.

Captura de tela das configurações da propriedade de distribuição do WSL

Observação

No meu caso, a pasta LocalState da minha distribuição do Ubuntu 18.04 estava localizada em C:\Users<my-user-name>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgscIn my case, the LocalState folder for my Ubuntu 18.04 distribution was located at C:\Users<my-user-name>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc

Para obter informações atualizadas, verifique o thread 4103 do GitHub dos documentos do WSL em que esse problema está sendo acompanhado.Check WSL Docs GitHub thread #4103 where this issue is being tracked for updated information.

  • O termo 'wsl' não é reconhecido como nome de um cmdlet, uma função, um arquivo de script ou um programa operável.The term 'wsl' is not recognized as the name of a cmdlet, function, script file, or operable program.

  • Erro: esta atualização se aplica somente a computadores com o Subsistema do Windows para Linux.Error: This update only applies to machines with the Windows Subsystem for Linux.

    • Para instalar o pacote MSI de atualização do kernel do Linux, o WSL é exigido e deve ser habilitado primeiro.To install the Linux kernel update MSI package, WSL is required and should be enabled first. Se ele falhar, você verá a mensagem: This update only applies to machines with the Windows Subsystem for Linux.If it fails, it you will see the message: This update only applies to machines with the Windows Subsystem for Linux.
    • Há três motivos possíveis para você ver essa mensagem:There are three possible reason you see this message:
    1. Você ainda está usando uma versão antiga do Windows, que não dá suporte ao WSL 2.You are still in old version of Windows which doesn't support WSL 2. Confira a etapa nº 2 para obter os requisitos de versão e os links a serem atualizados.See step #2 for version requirements and links to update.

    2. O WSL não está habilitado.WSL is not enabled. Você precisará retornar à etapa nº 1 e verificar se o recurso opcional do WSL está habilitado no seu computador.You will need to return to step #1 and ensure that the optional WSL feature is enabled on your machine.

    3. Depois que você habilitar o WSL, uma reinicialização será exigida para que ele entre em vigor. Reinicialize o computador e tente novamente.After you enabled WSL, a reboot is required for it to take effect, reboot your machine and try again.

  • Erro: o WSL 2 exige uma atualização do componente kernel. Para obter mais informações, visite https://aka.ms/wsl2kernel.Error: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel .

    • Se o pacote do kernel do Linux está ausente na pasta %SystemRoot%\system32\lxss\tools, você encontra esse erro.If the Linux kernel package is missing in the %SystemRoot%\system32\lxss\tools folder, you will encounter this error. Resolva-o instalando o pacote MSI de atualização do kernel do Linux na etapa nº 4 das instruções de instalação.Resolve it by installing the Linux kernel update MSI package in step #4 of these installation instructions. Talvez você precise desinstalar o MSI em 'Adicionar ou Remover Programas' e instalar ele novamente.You may need to uninstall the MSI from 'Add or Remove Programs', and install it again.