Importar qualquer distribuição do Linux a ser usada com o WSL

2025-06-10

Você pode usar qualquer distribuição linux dentro do Subsistema do Windows para Linux (WSL), mesmo que não esteja disponível na Microsoft Store, importando-a com um arquivo tar.

Este artigo mostra como importar a distribuição do Linux, CentOS, para uso com o WSL, obtendo seu arquivo tar usando um contêiner do Docker. Esse processo pode ser aplicado para importar qualquer distribuição do Linux.

Obter um arquivo tar para a distribuição

Primeiro, você precisará obter um arquivo tar que contenha todos os binários do Linux para a distribuição.

Você pode obter um arquivo tar de várias maneiras, duas das quais incluem:

Baixe um arquivo tar fornecido. Você pode encontrar um exemplo do Alpine na seção "Mini Root Filesystem" do site de downloads do Alpine Linux.
Localize um contêiner de distribuição do Linux e exporte uma instância como um arquivo tar. O exemplo a seguir mostrará esse processo usando o contêiner CentOS.

Obtendo um arquivo tar para exemplo de CentOS

Neste exemplo, usaremos o Docker dentro de uma distribuição WSL para obter o arquivo tar para CentOS.

Pré-requisitos

Você deve ter o WSL habilitado com uma distribuição do Linux instalada executando o WSL 2.
Você deve ter o Docker Desktop para Windows instalado com o mecanismo WSL 2 habilitado e a integração marcada Consulte o contrato de licença do Docker Desktop para obter atualizações sobre os termos de uso.

Exportar o tar de um contêiner

Abra a linha de comando (Bash) para uma distribuição do Linux que você já instalou na Microsoft Store (Ubuntu neste exemplo).
Verifique se você tem o Docker Desktop em execução (ou se você tiver o Docker instalado na distribuição do WSL, inicie o serviço com sudo service docker start )
Execute o contêiner do CentOS dentro do Docker:
```
docker run -t --name wsl_export centos ls /
```
Exporte a ID do contêiner para um arquivo tar em sua unidade c montada:
```
docker export wsl_export > /mnt/c/temp/centos.tar
```
Limpar o contêiner
```
docker rm wsl_export
```

Exemplo de execução dos comandos acima

Esse processo exporta o arquivo tar CentOS do contêiner do Docker para que agora possamos importá-lo para uso local com o WSL.

Importar o arquivo tar para o WSL

Depois de ter um arquivo tar pronto, você poderá importá-lo usando o comando: wsl --import <Distro> <InstallLocation> <FileName>.

Exemplo de importação do CentOS

Para importar o arquivo tar de distribuição do CentOS para o WSL:

Abra o PowerShell e verifique se você tem uma pasta criada onde deseja que a distribuição seja armazenada.
```
cd C:\temp
mkdir E:\wslDistroStorage\CentOS
```
Use o comando wsl --import <DistroName> <InstallLocation> <InstallTarFile> para importar o arquivo tar.
```
wsl --import CentOS E:\wslDistroStorage\CentOS .\centos.tar
```
Use o comando wsl -l -v para verificar quais distribuições você instalou.
Por fim, use o comando wsl -d CentOS para executar sua distribuição do CentOS Linux recém-importada.

Adicionar componentes específicos para o WSL, como um usuário padrão

Por padrão, ao usar --import, você sempre é iniciado como o usuário raiz. Você pode configurar sua própria conta de usuário, mas observe que o processo de configuração variará ligeiramente com base em cada distribuição diferente do Linux.

Para configurar a conta de usuário com a distribuição centOS que acabamos de importar, primeiro abra o PowerShell e inicialize no CentOS usando o comando:

wsl -d CentOS

Em seguida, abra a linha de comando do CentOS. Use este comando para instalar as ferramentas de configuração de sudo e senha no CentOS, criar uma conta de usuário e defini-la como o usuário padrão. Neste exemplo, o nome de usuário será 'caloewen'.

Observação

Você desejará adicionar o nome de usuário ao arquivo sudoers para permitir que o usuário use sudo. O comando adduser -G wheel $myUsername adiciona o usuário myUsername ao grupo wheel. Os usuários no grupo wheel recebem automaticamente privilégios sudo e podem executar tarefas que exigem permissão administrativa.

yum update -y && yum install passwd sudo -y
myUsername=caloewen
adduser -G wheel $myUsername
echo -e "[user]\ndefault=$myUsername" >> /etc/wsl.conf
passwd $myUsername

Agora você deve sair dessa instância e garantir que todas as instâncias do WSL sejam encerradas. Inicie a distribuição novamente para ver o novo usuário padrão executando este comando no PowerShell:

wsl --terminate CentOS
wsl -d CentOS

Agora você verá [caloewen@loewen-dev]$ como a saída com base neste exemplo.

Exemplo do código acima em execução no WSL

Para saber mais sobre como definir as configurações do WSL, consulte Definir configurações com .wslconfig e wsl.conf.

Usar uma distribuição personalizada do Linux

Você pode criar sua própria distribuição personalizada do Linux, empacotada como um aplicativo UWP, que se comportará exatamente como as distribuições WSL disponíveis na Microsoft Store. Para saber como, confira Como criar uma distribuição personalizada do Linux para WSL.