O Windows Subsystem for Linux (WSL) permite executar distribuições Linux diretamente no Windows. A seguir, um guia detalhado e passo a passo para instalar e configurar o WSL manualmente usando comandos no PowerShell. Este guia é baseado na instalação manual, recomendada para maior controle. Após a instalação, explicarei a configuração do arquivo .wslconfig
, incluindo os principais parâmetros na seção [wsl2]
.
Pré-requisitos
- Certifique-se de que seu Windows está na versão 10 (build 19041 ou superior) ou Windows 11.
- Abra o PowerShell como administrador (clique direito em PowerShell e selecione "Executar como administrador").
Passo 1: Habilitar os Recursos Necessários do Windows
- No PowerShell como administrador, execute o comando para habilitar o componente "Virtual Machine Platform", essencial para o WSL 2:
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
- Pode ser necessário reiniciar o computador para aplicar as mudanças.
Passo 2: Baixar e Instalar o Pacote MSI do WSL (para Instalação Offline, se Necessário)
- Baixe o pacote MSI mais recente do WSL da página de releases no GitHub: https://github.com/microsoft/wsl/releases.
- Instale o pacote baixado. Isso é opcional se você estiver online, mas garante uma instalação manual completa.
Passo 3: Instalar uma Distribuição Linux
- Liste as distribuições disponíveis para download:
wsl.exe --list --online
- Instale uma distribuição específica (exemplo: Ubuntu):
wsl.exe --install -d Ubuntu
- Substitua
Ubuntu
pelo nome da distribuição desejada (como Debian, Fedora, etc.). Se não especificar, o Ubuntu é instalado por padrão.
- Substitua
- Aguarde a descompactação dos arquivos. Isso pode levar alguns minutos.
Passo 4: Configurar o Usuário Linux
- Ao abrir a distribuição pela primeira vez (via prompt ou menu Iniciar), você será solicitado a criar um nome de usuário e senha para a conta Linux. Siga as instruções na janela do console.
Passo 5: Verificar e Configurar a Versão do WSL
- Verifique a versão das distribuições instaladas:
wsl.exe --list --verbose
- Defina a versão padrão para novas instalações (recomendado WSL 2):
wsl.exe --set-default-version 2
- Para atualizar uma distribuição específica para WSL 2:
wsl.exe --set-version Ubuntu 2
- Substitua
Ubuntu
pelo nome da sua distribuição.
- Substitua
Passo 6: Configurar Distribuição Padrão e Executar Comandos
- Defina uma distribuição como padrão:
wsl.exe --set-default Ubuntu
- Para executar comandos em uma distribuição específica sem alterar o padrão:
wsl.exe --distribution Ubuntu
- Para sair de uma sessão WSL no PowerShell, digite:
exit
Passos Pós-Instalação
- Instale o Windows Terminal para uma melhor experiência (disponível na Microsoft Store).
- Atualize o WSL para features de preview, se desejar:
wsl.exe --update --pre-release
- Configure seu ambiente de desenvolvimento: instale Git, editores de código, etc., dentro da distribuição Linux.
- Para parar todas as instâncias do WSL (útil para aplicar configurações):
wsl.exe --shutdown
Agora que o WSL está instalado, vamos à configuração avançada via arquivo .wslconfig
.
Configuração do Arquivo .wslconfig
O arquivo .wslconfig
é usado para definir configurações globais para todas as distribuições Linux rodando no WSL 2. Ele afeta a máquina virtual que executa o WSL. O arquivo não existe por padrão e deve ser criado no diretório %UserProfile%
(acessível via cd ~
no PowerShell ou digitando %UserProfile%
no Explorador de Arquivos). O caminho típico é C:\Users\<SeuNomeDeUsuario>\.wslconfig
.
- Crie o arquivo com um editor de texto (como Notepad) e salve-o como
.wslconfig
(sem extensão .txt). - As configurações são aplicadas na seção
[wsl2]
. - Após editar, reinicie o WSL com
wsl --shutdown
para aplicar as mudanças. - Requer Windows build 19041 ou superior.
Se precisar de mais detalhes ou troubleshooting, consulte a documentação oficial da Microsoft.
(Continua...)