Ir al contenido

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.

0vues

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).


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) :

Ventana de terminal
wsl --shutdown

Phase 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 :

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

Phase 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 :

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. 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»
Ventana de terminal
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.

Force le téléchargement direct du package mis à jour en dehors du magasin s'il existe des restrictions de réseau d'entreprise :

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. 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 obligatoria
C:\Users\usuario.demo\.wslconfig

Extension 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 :

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

Configuration 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 :

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

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 :

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

4. 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 :
    Ventana de terminal
    sudo systemctl stop tailscaled
    Et redémarrez l'environnement à partir de CMD : wsl --shutdown.

Si le pont réseau ne monte pas l'adaptateur virtuel après une mise à jour de Windows :

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

Cause 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 :

Ventana de terminal
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 :

ObjectifCommande
Lister les distributions et vérifier la version (v1 ou v2)wsl --list --verbose
Accéder directement avec les privilèges rootwsl -d kali-linux --user root
Libérer les blocages du service NATnet stop winnat; net start winnat
Forcer l'arrêt de l'hyperviseurwsl --shutdown
Auditer la table de routage sous Linuxip 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 wsl initialise le shell en moins de 2 secondes.
  • ✓ Miroir Actif : ip a sous 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.