Diagnostic et configuration avancée de WSL2
Résolution des incidents de blocage du LxssManager, mise à jour du noyau et configuration réseau avancée en mode miroir (Mirrored) dans WSL2.
Ce guide technique compile les procédures avancées de diagnostic, de réparation et de configuration du système de réseau pour le sous-système Windows pour Linux (WSL2). Il se concentre sur la résolution du blocage infini des processus (LxssManager), la transition vers la version moderne du magasin et l'optimisation de la routage en utilisant le mode de réseau miroir (Mirrored).
1. Diagnostic du blocage infini de WSL
Sección titulada «1. Diagnóstico del Bloqueo Infinito de WSL»Symptôme technique
Sección titulada «Síntoma Técnico»Lors de la tentative d'exécution de wsl ou wsl -d <distro>, la console clignote et entre dans un état suspendu continu sans charger la shell. Lors de la tentative de forcer l'arrêt avec wsl --shutdown, le terminal se bloque indéfiniment sur l'instruction “Arrêt…”.
Phase 1 : Tentative d'arrêt contrôlé (Soft Kill)
Sección titulada «Fase 1: Intento de Parada Controlada (Soft Kill)»Exécutez l'arrêt natif du sous-système via l'Invite de commandes (CMD) :
wsl --shutdownPhase 2 : Arrêt forcé des threads et processus (Hard Kill)
Sección titulada «Fase 2: Parada Forzada de Hilos y Procesos (Hard Kill)»Si l'arrêt progressif ne répond pas, il est obligatoire de terminer les sous-processus de la machine virtuelle de l'hyperviseur (vmmem) et les gestionnaires de threads de l'hôte. Ouvrez PowerShell en tant qu'administrateur et exécutez :
taskkill /f /fi "imagename eq wsl*"taskkill /f /im vmmemtaskkill /f /im wslhost.exetaskkill /f /im conhost.exePhase 3 : Libérer le blocage du noyau (LxssManager Hang)
Sección titulada «Fase 3: Liberar el Bloqueo del Kernel (LxssManager Hang)»Si les commandes précédentes renvoient une erreur Accès refusé, un blocage au niveau du pilote s'est produit en raison d'une collision de ports réseau natifs (HNS/WinNAT).
La solution la plus rapide et la plus intelligente consiste à redémarrer le service NAT de Windows pour débloquer les sockets du noyau :
# 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. Mise à jour de WSL (Legacy vs. Microsoft Store)
Sección titulada «2. Actualización de WSL (Legacy vs. Microsoft Store)»Pour activer des fonctionnalités de virtualisation avancées telles que le mode Mirrored, il est obligatoire de migrer de la version de WSL historiquement intégrée à Windows (Legacy) vers la version découplée distribuée par le Microsoft Store.
Vérifier la version de la pile d'exécution
Sección titulada «Comprobar Versión de la Pila de Ejecución»wsl --version- Si un message d'erreur ou une syntaxe incorrecte est renvoyé : Le système fonctionne sous la version d'architecture Legacy obsolète.
- Si vous affichez un tableau avec les versions du noyau et de WSL : le système fonctionne avec la version de la Microsoft Store.
Flux de mise à jour manuelle
Sección titulada «Flujo de Actualización Manual»Force le téléchargement direct du package mis à jour en dehors du magasin s'il existe des restrictions de réseau d'entreprise :
# 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. Topologie réseau : Mode NAT vs. Miroir (Mirrored)
Sección titulada «3. Topología de Red: Modo NAT vs. Espejo (Mirrored)»Fichier de configuration de l'environnement .wslconfig
Sección titulada «Archivo de Configuración de Entorno .wslconfig»Pour définir la topologie au niveau du matériel virtuel, créez le fichier de configuration globale à la racine de votre profil d'utilisateur Windows :
:: Ruta de destino obligatoriaC:\Users\usuario.demo\.wslconfigExtension du fichier
Assurez-vous que votre explorateur de fichiers n'ajoute pas de manière invisible l'extension .txt à la fin. S'il est créé sous la forme .wslconfig.txt, le moteur WSL ignorera complètement la directive. Vous pouvez le corriger avec PowerShell :
Rename-Item -Path "C:\Users\usuario.demo\.wslconfig.txt" -NewName ".wslconfig" -ForceConfiguration A : Mode Miroir (Mirrored) - Recommandé
Sección titulada «Configuración A: Modo Espejo (Mirrored) - Recomendado»Copie les interfaces et les adresses IP de votre machine Windows directement à l'intérieur de votre machine virtuelle Linux. C'est la configuration standard par excellence pour les audits réseau, le pentesting et le déploiement de microservices :
[wsl2]networkingMode=mirroreddnsTunneling=trueautoProxy=truefirewall=trueConfiguration B : Mode NAT classique
Sección titulada «Configuración B: Modo NAT Clásico»Maintient la machine virtuelle isolée au sein d'un sous-réseau virtuel propre et indépendant (généralement 172.x.x.x), en acheminant le trafic via l'hôte :
[wsl2]networkingMode=nat4. Résolution des problèmes de perte de connectivité
Sección titulada «4. Resolución de Incidencias de Pérdida de Conectividad»Cause 1 : Conflits avec les adaptateurs réseau virtuels (VPN / Tailscale)
Sección titulada «Causa 1: Conflictos con Adaptadores de Red Virtuales (VPN / Tailscale)»Les réseaux VPN de l'hôte peuvent intercepter la création du pont réseau miroir de WSL.
- Solution : Arrêtez momentanément le service VPN sous Windows. Si vous utilisez des services sur votre machine Linux, assurez-vous de les suspendre avant de les éteindre :
Et redémarrez l'environnement à partir de CMD :
Ventana de terminal sudo systemctl stop tailscaledwsl --shutdown.
Cause 2 : Corruption des sockets Winsock
Sección titulada «Causa 2: Corrupción en los Sockets de Winsock»Si le pont réseau ne monte pas l'adaptateur virtuel après une mise à jour de Windows :
# Ejecutar en PowerShell como Administrador y reiniciar el PCnetsh int ip resetnetsh winsock resetCause 3 : Blocage du trafic entrant par le pare-feu Windows
Sección titulada «Causa 3: Bloqueo de Tráfico entrante por el Firewall de Windows»Le pare-feu Windows Defender bloque par défaut les connexions entrantes non reconnues provenant de l'adaptateur virtuel WSL. Activez une règle permissive dédiée :
New-NetFirewallRule -DisplayName "WSL Permitir Todo" -Direction Inbound -Action Allow -Program "System"5. Cheat Sheet : Commandes opérationnelles de secours
Sección titulada «5. Cheat Sheet: Comandos Operativos de Rescate»Exécuter depuis PowerShell / CMD avec des privilèges élevés :
| Objectif | Commande |
|---|---|
| Lister les distributions et vérifier la version (v1 ou v2) | wsl --list --verbose |
| Accéder directement avec les privilèges root | wsl -d kali-linux --user root |
| Libérer les blocages du service NAT | net stop winnat; net start winnat |
| Forcer l'arrêt de l'hyperviseur | wsl --shutdown |
| Auditer la table de routage sous Linux | ip a ou ip route |
6. Checklist de validation et de succès
Sección titulada «6. Checklist de Validación y Éxito»- ✓ Stabilité : La commande
wslinitialise le shell en moins de 2 secondes. - ✓ Miroir Actif :
ip asous Linux reflète la même IP physique du réseau WiFi/Ethernet de Windows. - ✓ Synchronisation : Aucune collision réseau après la désactivation contrôlée du pilote Tailscale.

