Ir al contenido

Diagnóstico e Configuração Avançada do WSL2

Resolução de problemas de bloqueio do LxssManager, atualização do kernel e configuração avançada de rede espelhada (Mirrored) no WSL2.

0lecturas

Este guia técnico compila os procedimentos avançados de diagnóstico, reparação e configuração do sistema de rede para o Subsistema de Windows para Linux (WSL2). Foca na resolução do bloqueio infinito de processos (LxssManager), na transição para a versão moderna da loja e na otimização do roteamento através do modo de rede espelhada (Mirrored).


Ao tentar executar wsl ou wsl -d <distro>, a consola pisca e entra num estado suspenso contínuo sem carregar a shell. Ao tentar forçar a parada com wsl --shutdown, o terminal congela indefinidamente na instrução “Parando…”.

Fase 1: Tentativa de Parada Controlada (Soft Kill)

Sección titulada «Fase 1: Intento de Parada Controlada (Soft Kill)»

Execute a parada nativa do subsistema através do Prompt de Comando (CMD):

Ventana de terminal
wsl --shutdown

Fase 2: Parada Forçada de Threads e Processos (Hard Kill)

Sección titulada «Fase 2: Parada Forzada de Hilos y Procesos (Hard Kill)»

Se a parada suave não responder, é obrigatório encerrar os subprocessos da máquina virtual do hipervisor (vmmem) e os gerenciadores de threads do host. Abra o PowerShell como Administrador e execute:

Ventana de terminal
taskkill /f /fi "imagename eq wsl*"
taskkill /f /im vmmem
taskkill /f /im wslhost.exe
taskkill /f /im conhost.exe

Fase 3: Liberar o Bloqueio do Kernel (LxssManager Hang)

Sección titulada «Fase 3: Liberar el Bloqueo del Kernel (LxssManager Hang)»

Se os comandos anteriores retornarem um erro de Acesso Negado, ocorreu um bloqueio ao nível de driver por colisão de portas de rede nativas (HNS/WinNAT).

A solução mais rápida e inteligente consiste em reiniciar o serviço NAT do Windows para desbloquear os sockets do kernel:

Ventana de terminal
# 1. Detener el servicio NAT (Libera instantáneamente el bloqueo de WSL)
net stop winnat
# 2. Iniciar el servicio de nuevo
net start winnat
# 3. Localizar el PID del servicio LxssManager si el cuelgue persiste
tasklist /svc /fi "imagename eq svchost.exe" | findstr LxssManager
# 4. Forzar la finalización del hilo svchost por PID (Ejemplo: PID 36080)
Stop-Process -Id <PID> -Force

2. Atualização do WSL (Legacy vs. Microsoft Store)

Sección titulada «2. Actualización de WSL (Legacy vs. Microsoft Store)»

Para habilitar recursos avançados de virtualização como o modo Mirrored, é obrigatório migrar da versão do WSL historicamente integrada ao Windows (Legacy) para a versão desacoplada distribuída pela Microsoft Store.

Ventana de terminal
wsl --version
  • Se retornar uma mensagem de erro ou sintaxe incorreta: O sistema opera sob a versão de arquitetura Legacy obsoleta.
  • Se imprimir uma tabela com versões do kernel e WSL: O sistema opera sob a versão da Microsoft Store.

Força o download direto do pacote atualizado fora da loja se existirem restrições corporativas de rede:

Ventana de terminal
# Actualizar el kernel a la versión de la Store
wsl --update
# Forzar la descarga por web de existir bloqueos en la Store
wsl --update --web-download
# Consolidar los cambios apagando el hipervisor
wsl --shutdown

3. Topologia de Rede: Modo NAT vs. Espelho (Mirrored)

Sección titulada «3. Topología de Red: Modo NAT vs. Espejo (Mirrored)»

Arquivo de Configuração de Ambiente .wslconfig

Sección titulada «Archivo de Configuración de Entorno .wslconfig»

Para definir a topologia a nível de hardware virtual, crie o arquivo de configuração global na raiz do seu perfil de usuário do Windows:

:: Ruta de destino obligatoria
C:\Users\usuario.demo\.wslconfig

Extensão do Arquivo

Asegure-se de que seu explorador de arquivos não adicione de forma invisível a extensão .txt ao final. Se criar como .wslconfig.txt, o motor de WSL ignorará a diretiva por completo. Pode corrigir com PowerShell:

Ventana de terminal
Rename-Item -Path "C:\Users\usuario.demo\.wslconfig.txt" -NewName ".wslconfig" -Force

Configuração A: Modo Espelho (Mirrored) - Recomendado

Sección titulada «Configuración A: Modo Espejo (Mirrored) - Recomendado»

Copia as interfaces e endereços IP da sua máquina Windows diretamente para o interior da sua máquina virtual Linux. É a configuração padrão de excelência para auditorias de rede, pentesting e implantação de microsserviços:

C:\Users\usuario.demo\.wslconfig
[wsl2]
networkingMode=mirrored
dnsTunneling=true
autoProxy=true
firewall=true

Mantenha a máquina virtual isolada dentro de uma sub-rede virtual própria e independente (tipicamente 172.x.x.x), roteando o tráfego através do anfitrião:

C:\Users\usuario.demo\.wslconfig
[wsl2]
networkingMode=nat

4. Resolução de Problemas de Perda de Conectividade

Sección titulada «4. Resolución de Incidencias de Pérdida de Conectividad»

Causa 1: Conflitos com Adaptadores de Rede Virtuais (VPN / Tailscale)

Sección titulada «Causa 1: Conflictos con Adaptadores de Red Virtuales (VPN / Tailscale)»

As redes VPN do host podem interceptar a criação da ponte espelho de rede do WSL.

  • Solução: Detenha momentaneamente o serviço VPN no Windows. Se você usa serviços na sua máquina Linux, certifique-se de suspendê-los antes de desligar:
    Ventana de terminal
    sudo systemctl stop tailscaled
    E reinicie o ambiente a partir do CMD: wsl --shutdown.

Se a ponte de rede não levantar o adaptador virtual após uma atualização do Windows:

Ventana de terminal
# Ejecutar en PowerShell como Administrador y reiniciar el PC
netsh int ip reset
netsh winsock reset

Causa 3: Bloqueio de Tráfego de entrada pelo Firewall do Windows

Sección titulada «Causa 3: Bloqueo de Tráfico entrante por el Firewall de Windows»

O Firewall do Windows Defender bloqueia por padrão conexões de entrada não reconhecidas provenientes do adaptador virtual do WSL. Habilite uma regra permissiva dedicada:

Ventana de terminal
New-NetFirewallRule -DisplayName "WSL Permitir Todo" -Direction Inbound -Action Allow -Program "System"

5. Cheat Sheet: Comandos Operacionais de Resgate

Sección titulada «5. Cheat Sheet: Comandos Operativos de Rescate»

Executar a partir do PowerShell / CMD com privilégios elevados:

ObjetivoComando
Listar distros e verificar versão (v1 ou v2)wsl --list --verbose
Acceder directamente com privilégios de rootwsl -d kali-linux --user root
Liberar cuelgues del servicio NATnet stop winnat; net start winnat
Apagar de forma forzada el hipervisorwsl --shutdown
Auditar la tabla de direccionamiento en Linuxip a ou ip route

  • ✓ Estabilidade: O comando wsl inicia a shell em menos de 2 segundos.
  • ✓ Espejo Activo: ip a dentro de Linux reflete a mesma IP física da rede WiFi/Ethernet de Windows.
  • ✓ Sincronização: Sem colisões de rede após a desativação controlada do driver de Tailscale.