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.
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).
1. Diagnòstic del bloqueig infinit de WSL
Sección titulada «1. Diagnóstico del Bloqueo Infinito de WSL»Síntoma Tècnic
Sección titulada «Síntoma Técnico»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):
wsl --shutdownFase 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:
taskkill /f /fi "imagename eq wsl*"taskkill /f /im vmmemtaskkill /f /im wslhost.exetaskkill /f /im conhost.exeFase 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:
# 1. Detener el servicio NAT (Libera instantáneamente el bloqueo de WSL)net stop winnat
# 2. Iniciar el servicio de nuevonet start winnat
# 3. Localizar el PID del servicio LxssManager si el cuelgue persistetasklist /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> -Force2. 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.
Comprovar la versió de la pila d'execució
Sección titulada «Comprobar Versión de la Pila de Ejecución»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.
Flux d'Actualització Manual
Sección titulada «Flujo de Actualización Manual»Força la descàrrega directa del paquet actualitzat fora de la botiga si hi ha restriccions corporatives de xarxa:
# Actualizar el kernel a la versión de la Storewsl --update
# Forzar la descarga por web de existir bloqueos en la Storewsl --update --web-download
# Consolidar los cambios apagando el hipervisorwsl --shutdown3. Topologia de Xarxa: Mode NAT vs. Mirall (Mirrored)
Sección titulada «3. Topología de Red: Modo NAT vs. Espejo (Mirrored)»Arxiu de Configuració d'Entorn .wslconfig
Sección titulada «Archivo de Configuración de Entorno .wslconfig»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 obligatoriaC:\Users\usuario.demo\.wslconfigExtensió 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:
Rename-Item -Path "C:\Users\usuario.demo\.wslconfig.txt" -NewName ".wslconfig" -ForceConfiguració 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:
[wsl2]networkingMode=mirroreddnsTunneling=trueautoProxy=truefirewall=trueConfiguració B: Mode NAT Clàssic
Sección titulada «Configuración B: Modo NAT Clásico»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:
[wsl2]networkingMode=nat4. 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:
I reinicia l'entorn des de CMD:
Ventana de terminal sudo systemctl stop tailscaledwsl --shutdown.
Causa 2: Corrupció en els Sockets de Winsock
Sección titulada «Causa 2: Corrupción en los Sockets de Winsock»Si el pont de xarxa no activa l'adaptador virtual després d'una actualització de Windows:
# Ejecutar en PowerShell como Administrador y reiniciar el PCnetsh int ip resetnetsh winsock resetCausa 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:
New-NetFirewallRule -DisplayName "WSL Permitir Todo" -Direction Inbound -Action Allow -Program "System"5. Cheat Sheet: Comandes Operatives de Rescat
Sección titulada «5. Cheat Sheet: Comandos Operativos de Rescate»Executar des de PowerShell / CMD amb privilegis elevats:
| Objectiu | Comanda |
|---|---|
| Llistar distros i verificar versió (v1 o v2) | wsl --list --verbose |
| Accedir directament amb privilegis de root | wsl -d kali-linux --user root |
| Alliberar bloquejos del servei NAT | net stop winnat; net start winnat |
| Apagar de manera forçada l'hipervisor | wsl --shutdown |
| Auditar la taula d'adreçament a Linux | ip a o ip route |
6. Checklist de validació i èxit
Sección titulada «6. Checklist de Validación y Éxito»- ✓ Estabilitat: La comanda
wslinicialitza la shell en menys de 2 segons. - ✓ Mirall actiu:
ip adins 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.

