Ir al contenido

Diagnóstico y Configuración Avanzada de WSL2

Resolución de incidencias de bloqueo del LxssManager, actualización del kernel y configuración avanzada de red espejada (Mirrored) en WSL2.

0lecturas

Esta guía técnica compila los procedimientos avanzados de diagnóstico, reparación y configuración del sistema de red para el Subsistema de Windows para Linux (WSL2). Se enfoca en solucionar el bloqueo infinito de procesos (LxssManager), la transición a la versión moderna de la tienda, y la optimización del enrutamiento mediante el modo de red espejado (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: Intento de Parada Controlada (Soft Kill)

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

Ejecuta la detención nativa del subsistema a través del Símbolo del Sistema (CMD):

Ventana de terminal
wsl --shutdown

Fase 2: Parada Forzada de Hilos y Procesos (Hard Kill)

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

Si la parada suave no responde, es obligatorio terminar los subprocesos de la máquina virtual del hipervisor (vmmem) y los gestores de hilos del anfitrión. Abre PowerShell como Administrador y ejecuta:

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 el Bloqueo del Kernel (LxssManager Hang)

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

Si los comandos anteriores devuelven un error de Acceso Denegado, se ha producido un bloqueo a nivel de controlador por colisión de puertos de red nativos (HNS/WinNAT).

La solución más rápida e inteligente consiste en reiniciar el servicio NAT de Windows para desbloquear los 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. Actualización de WSL (Legacy vs. Microsoft Store)

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

Para habilitar características avanzadas de virtualización como el modo Mirrored, es obligatorio migrar de la versión de WSL integrada históricamente en Windows (Legacy) a la versión desacoplada distribuida por la Microsoft Store.

Ventana de terminal
wsl --version
  • Si devuelve un mensaje de error o sintaxis incorrecta: El sistema opera bajo la versión de arquitectura Legacy obsoleta.
  • Si imprime una tabla con versiones del kernel y WSL: El sistema opera bajo la versión de la Microsoft Store.

Fuerza la descarga directa del paquete actualizado fuera de la tienda si existen restricciones corporativas de red:

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. Topología de Red: Modo NAT vs. Espejo (Mirrored)

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

Archivo de Configuración de Entorno .wslconfig

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

Para definir la topología a nivel de hardware virtual, crea el archivo de configuración global en la raíz de tu perfil de usuario de Windows:

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

Extensión del Archivo

Asegúrate de que tu explorador de archivos no añada de forma invisible la extensión .txt al final. Si se crea como .wslconfig.txt, el motor de WSL ignorará la directiva por completo. Puedes corregirlo con PowerShell:

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

Configuración A: Modo Espejo (Mirrored) - Recomendado

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

Copia las interfaces y direcciones IP de tu máquina Windows directamente en el interior de tu máquina virtual Linux. Es la configuración estándar de excelencia para auditorías de red, pentesting y despliegue de microservicios:

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

Mantiene a la máquina virtual aislada dentro de una subred virtual propia e independiente (típicamente 172.x.x.x), enrutando el tráfico a través del anfitrión:

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

4. Resolución de Incidencias de Pérdida de Conectividad

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

Causa 1: Conflictos con Adaptadores de Red Virtuales (VPN / Tailscale)

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

Las redes VPN del anfitrión pueden interceptar la creación del puente espejo de red de WSL.

  • Solución: Detén momentáneamente el servicio VPN en Windows. Si usas servicios en tu máquina Linux, asegúrate de suspenderlos antes de apagar:
    Ventana de terminal
    sudo systemctl stop tailscaled
    Y reinicia el entorno desde CMD: wsl --shutdown.

Causa 2: Corrupción en los Sockets de Winsock

Sección titulada «Causa 2: Corrupción en los Sockets de Winsock»

Si el puente de red no levanta el adaptador virtual tras una actualización de Windows:

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

Causa 3: Bloqueo de Tráfico entrante por el Firewall de Windows

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

El Firewall de Windows Defender bloquea por defecto conexiones entrantes no reconocidas procedentes del adaptador virtual de WSL. Habilita una regla permisiva dedicada:

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

5. Cheat Sheet: Comandos Operativos de Rescate

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

Ejecutar desde PowerShell / CMD con privilegios elevados:

ObjetivoComando
Listar distros y verificar versión (v1 o v2)wsl --list --verbose
Acceder directamente con privilegios 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 o ip route

  • ✓ Estabilidad: El comando wsl inicializa la shell en menos de 2 segundos.
  • ✓ Espejo Activo: ip a dentro de Linux refleja la misma IP física de la red WiFi/Ethernet de Windows.
  • ✓ Sincronización: Sin colisiones de red tras la desactivación controlada del driver de Tailscale.