Ir al contenido

Diagnòstic i configuració avançada de WSL2

Resolució d'incidències de bloqueig del LxssManager, actualització del kernel i configuració avançada de xarxa en mode mirall (Mirrored) a WSL2.

0lectures

Aquesta guia tècnica compila els procediments avançats de diagnòstic, reparació i configuració del sistema de xarxa per al Subsistema de Windows per a Linux (WSL2). Es centra en solucionar el bloqueig infinit de processos (LxssManager), la transició a la versió moderna de la botiga i l'optimització de l'enrutament mitjançant el mode de xarxa mirall (Mirrored).


Al intentar ejecutar wsl o wsl -d <distro>, la consola parpadea y entra en un estado suspendido continuo sin cargar la shell. Al intentar forzar la parada con wsl --shutdown, la terminal se congela indefinidamente en la instrucción “Deteniendo…”.

Fase 1: Intent de Parada Controlada (Soft Kill)

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

Executa la detenció nativa del subsistema a través del Símbol del Sistema (CMD):

Ventana de terminal
wsl --shutdown

Fase 2: Parada Forçada de Fils i Processos (Hard Kill)

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

Si la parada suau no respon, és obligatori finalitzar els subprocessos de la màquina virtual de l'hipervisor (vmmem) i els gestors de fils de l'host. Obre PowerShell com a Administrador i executa:

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: Alliberar el Bloqueig del Kernel (LxssManager Hang)

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

Si els comandaments anteriors retornen un error de Accés Denegat, s'ha produït un bloqueig a nivell de controlador per col·lisió de ports de xarxa natius (HNS/WinNAT).

La solució més ràpida i intel·ligent consisteix a reiniciar el servei NAT de Windows per desbloquejar els sockets del 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. Actualització de WSL (Legacy vs. Microsoft Store)

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

Per habilitar característiques avançades de virtualització com el mode Mirrored, és obligatori migrar de la versió de WSL integrada històricament a Windows (Legacy) a la versió desacoblada distribuïda per la Microsoft Store.

Ventana de terminal
wsl --version
  • Si retorna un missatge d'error o una sintaxi incorrecta: El sistema opera sota la versió d'arquitectura Legacy obsoleta.
  • Si imprime una taula amb les versions del kernel i WSL: El sistema opera sota la versió de la Microsoft Store.

Força la descàrrega directa del paquet actualitzat fora de la botiga si hi ha restriccions corporatives de xarxa:

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 Xarxa: Mode NAT vs. Mirall (Mirrored)

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

Per definir la topologia a nivell de hardware virtual, crea l'arxiu de configuració global a l'arrel del teu perfil d'usuari de Windows:

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

Extensió de l'Arxiu

Assegura't que el teu explorador de fitxers no afegisca de forma invisible l'extensió .txt al final. Si es crea com .wslconfig.txt, el motor de WSL ignorarà la directiva completament. Pots corregir-ho amb PowerShell:

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

Configuració A: Mode Mirall (Mirrored) - Recomanat

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

Copia les interfícies i adreces IP de la teva màquina Windows directament al seu interior de la teva màquina virtual Linux. És la configuració estàndard d'excel·lència per a auditories de xarxa, pentesting i desplegament de microserveis:

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

Manté la màquina virtual aïllada dins d'una subxarxa virtual pròpia i independent (típicament 172.x.x.x), enrutant el trànsit a través de l'host:

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

4. Resolució d'Incidències de Pèrdua de Connectivitat

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

Causa 1: Conflicts amb Adaptadors de Xarxa Virtuals (VPN / Tailscale)

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

Les xarxes VPN de l'host poden interceptar la creació del pont mirall de xarxa de WSL.

  • Solució: Atura momentàniament el servei VPN en Windows. Si uses serveis en la teva màquina Linux, assegura't de suspendre'ls abans d'apagar:
    Ventana de terminal
    sudo systemctl stop tailscaled
    I reinicia l'entorn des de CMD: wsl --shutdown.

Si el pont de xarxa no activa l'adaptador virtual després d'una actualització de Windows:

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

Causa 3: Bloqueig de trànsit entrant pel Firewall de Windows

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

El Firewall de Windows Defender bloqueja per defecte connexions entrants no reconegudes procedentes de l'adaptador virtual de WSL. Habilita una regla permisiva dedicada:

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

Executar des de PowerShell / CMD amb privilegis elevats:

ObjectiuComanda
Llistar distros i verificar versió (v1 o v2)wsl --list --verbose
Accedir directament amb privilegis de rootwsl -d kali-linux --user root
Alliberar bloquejos del servei NATnet stop winnat; net start winnat
Apagar de manera forçada l'hipervisorwsl --shutdown
Auditar la taula d'adreçament a Linuxip a o ip route

  • ✓ Estabilitat: La comanda wsl inicialitza la shell en menys de 2 segons.
  • ✓ Mirall actiu: ip a dins de Linux reflecteix la mateixa IP física de la xarxa WiFi/Ethernet de Windows.
  • ✓ Sincronització: Sense col·lisions de xarxa després de la desactivació controlada del driver de Tailscale.