Ir al contenido

Diagnose en Geavanceerde Configuratie van WSL2

Resolutie van LxssManager-blokkeringsincidenten, kernel-updates en geavanceerde configuratie van gespiegelde netwerken (Mirrored) in WSL2.

0lecturas

Deze technische gids bundelt geavanceerde procedures voor diagnose, reparatie en netwerkconfiguratie voor het Windows Subsystem for Linux (WSL2). Het richt zich op het oplossen van oneindige procesblokkades (LxssManager), de overgang naar de moderne Store-versie en de optimalisatie van routing via de gespiegelde netwerkmodus (Mirrored).


Wanneer u wsl of wsl -d <distro> probeert uit te voeren, knippert de console en gaat deze in een continue onderbroken toestand zonder de shell te laden. Wanneer u wsl --shutdown probeert af te breken, blijft de terminal onbeperkt hangen in de instructie “Beëindigen…”.

Fase 1: Poging tot Gecontroleerde Stop (Soft Kill)

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

Voer de systeemeigen stop van het subsysteem uit via de Opdrachtprompt (CMD):

Ventana de terminal
wsl --shutdown

Fase 2: Geforceerde Stop van Threads en Processen (Hard Kill)

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

Als de zachte stop niet reageert, is het noodzakelijk om de subprocessen van de virtuele machine van de hypervisor (vmmem) en de thread-beheerders van de host te beëindigen. Open PowerShell als Administrator en voer uit:

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: Vrijgeven van de Kernel-blokkade (LxssManager Hang)

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

Als de bovenstaande commando's een foutmelding Toegang geweigerd geven, is er een blokkade op driverniveau opgetreden door een botsing van native netwerkpoorten (HNS/WinNAT).

De snelste en slimste oplossing is om de Windows NAT-service opnieuw te starten om de kernel-sockets te deblokkeren:

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

Om geavanceerde virtualisatiefuncties zoals de Mirrored-modus in te schakelen, is het verplicht om over te stappen van de historisch in Windows geïntegreerde WSL-versie (Legacy) naar de ontkoppelde versie die via de Microsoft Store wordt geleverd.

Ventana de terminal
wsl --version
  • Als er een foutmelding of onjuiste syntaxis wordt geretourneerd: Het systeem draait op de verouderde Legacy-architectuurversie.
  • Als er een tabel wordt weergegeven met kernel- en WSL-versies: Het systeem draait op de Microsoft Store-versie.

Forceer de directe download van het bijgewerkte pakket buiten de store om als er zakelijke netwerkbeperkingen zijn:

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. Netwerktopologie: NAT-modus vs. Gespiegeld (Mirrored)

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

Om de topologie op virtueel hardwareniveau te definiëren, maak je het globale configuratiebestand aan in de root van je Windows-gebruikersprofiel:

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

Bestandsextensie

Zorg ervoor dat je bestandsverkenner de extensie .txt niet onzichtbaar aan het einde toevoegt. Als het wordt aangemaakt als .wslconfig.txt, zal de WSL-engine de instructie volledig negeren. Je kunt dit corrigeren met PowerShell:

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

Configuratie A: Gespiegelde modus (Mirrored) - Aanbevolen

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

Kopieert de interfaces en IP-adressen van je Windows-machine direct naar de binnenkant van je virtuele Linux-machine. Dit is de uitstekende standaardconfiguratie voor netwerkaudits, pentesting en de implementatie van microservices:

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

Houdt de virtuele machine geïsoleerd binnen een eigen en onafhankelijk virtueel subnet (meestal 172.x.x.x), waarbij het verkeer via de host wordt gerouteerd:

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

Oorzaak 1: Conflicten met virtuele netwerkadapters (VPN / Tailscale)

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

De VPN-netwerken van de host kunnen het aanmaken van de WSL-netwerkspiegelbrug onderscheppen.

  • Oplossing: Stop de VPN-service in Windows tijdelijk. Als u services op uw Linux-machine gebruikt, zorg er dan voor dat u deze opschort voordat u deze afsluit:
    Ventana de terminal
    sudo systemctl stop tailscaled
    En herstart de omgeving vanuit CMD: wsl --shutdown.

Als de netwerkbrug de virtuele adapter niet activeert na een Windows-update:

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

Oorzaak 3: Blokkering van inkomend verkeer door Windows Firewall

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

Windows Defender Firewall blokkeert standaard onbekende inkomende verbindingen afkomstig van de virtuele WSL-adapter. Schakel een speciale toegangsregel in:

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

5. Cheat Sheet: Operationele reddingscommando's

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

Uitvoeren vanuit PowerShell / CMD met verhoogde rechten:

DoelCommando
Distro's opsommen en versie controleren (v1 of v2)wsl --list --verbose
Directe toegang met root-rechtenwsl -d kali-linux --user root
NAT-service vastlopen oplossennet stop winnat; net start winnat
Hypervisor geforceerd uitschakelenwsl --shutdown
Adresseringstabel in Linux auditerenip a of ip route

  • ✓ Stabiliteit: Het commando wsl initialiseert de shell in minder dan 2 seconden.
  • ✓ Actieve Mirroring: ip a binnen Linux weerspiegelt hetzelfde fysieke IP-adres van het Windows WiFi/Ethernet-netwerk.
  • ✓ Synchronisatie: Geen netwerkbotsingen na de gecontroleerde deactivering van de Tailscale-driver.