Ir al contenido

Diagnose und fortgeschrittene Konfiguration von WSL2

Fehlerbehebung bei LxssManager-Blockierungen, Kernel-Updates und fortgeschrittene Konfiguration des Mirrored-Netzwerkmodus in WSL2.

0Lesungen

Dieser technische Leitfaden bündelt die erweiterten Diagnose-, Reparatur- und Netzwerkkonfigurationsverfahren für das Windows-Subsystem für Linux (WSL2). Er konzentriert sich auf die Behebung des endlosen Blockierens von Prozessen (LxssManager), den Übergang zur modernen Store-Version und die Optimierung des Routings durch den Mirrored-Netzwerkmodus (Mirrored).


Beim Versuch, wsl oder wsl -d <distro> auszuführen, blinkt die Konsole und wechselt in einen kontinuierlich suspendierten Zustand, ohne die Shell zu laden. Beim Versuch, den Vorgang mit wsl --shutdown zu beenden, friert die Konsole auf dem Befehl „Beenden…“ ein.

Phase 1: Versuch eines kontrollierten Stopps (Soft Kill)

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

Führen Sie den nativen Stopp des Subsystems über die Eingabeaufforderung (CMD) aus:

Ventana de terminal
wsl --shutdown

Phase 2: Erzwungener Stopp von Threads und Prozessen (Hard Kill)

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

Wenn der Soft-Stop nicht reagiert, müssen die Unterprozesse der Hypervisor-VM (vmmem) und die Thread-Manager des Hosts beendet werden. Öffnen Sie PowerShell als Administrator und führen Sie aus:

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: Kernel-Blockade aufheben (LxssManager Hang)

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

Wenn die vorangegangenen Befehle einen Fehler Zugriff verweigert zurückgeben, ist eine Sperre auf Treiberebene aufgrund einer Kollision nativer Netzwerkports (HNS/WinNAT) aufgetreten.

Die schnellste und intelligenteste Lösung besteht darin, den Windows-NAT-Dienst neu zu starten, um die Kernel-Sockets zu entsperren:

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. Aktualisierung von WSL (Legacy vs. Microsoft Store)

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

Um fortschrittliche Virtualisierungsfunktionen wie den Mirrored-Modus zu aktivieren, ist es zwingend erforderlich, von der historisch in Windows integrierten WSL-Version (Legacy) auf die über den Microsoft Store bereitgestellte, entkoppelte Version zu migrieren.

Version des Ausführungs-Stacks überprüfen

Sección titulada «Comprobar Versión de la Pila de Ejecución»
Ventana de terminal
wsl --version
  • Wenn eine Fehlermeldung oder ein Syntaxfehler ausgegeben wird: Das System arbeitet mit der veralteten Legacy-Architekturversion.
  • Wenn eine Tabelle mit Kernel- und WSL-Versionen ausgegeben wird: Das System arbeitet mit der Microsoft Store-Version.

Erzwingt den direkten Download des aktualisierten Pakets außerhalb des Stores, falls unternehmensweite Netzwerkeinschränkungen bestehen:

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. Netzwerktopologie: NAT-Modus vs. Spiegelmodus (Mirrored)

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

Um die Topologie auf virtueller Hardwareebene zu definieren, erstellen Sie die globale Konfigurationsdatei im Stammverzeichnis Ihres Windows-Benutzerprofils:

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

Dateierweiterung

Stelle sicher, dass dein Dateiexplorer die Erweiterung .txt nicht unsichtbar am Ende hinzufügt. Wenn sie als .wslconfig.txt erstellt wird, ignoriert die WSL-Engine die Richtlinie vollständig. Du kannst dies mit PowerShell korrigieren:

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

Konfiguration A: Spiegelmodus (Mirrored) - Empfohlen

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

Kopiert die Schnittstellen und IP-Adressen Ihres Windows-Rechners direkt in Ihre virtuelle Linux-Maschine. Dies ist die Standardkonfiguration par excellence für Netzwerk-Audits, Pentesting und die Bereitstellung von Microservices:

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

Konfiguration B: Klassischer NAT-Modus

Sección titulada «Configuración B: Modo NAT Clásico»

Hält die virtuelle Maschine isoliert in einem eigenen und unabhängigen virtuellen Subnetz (typischerweise 172.x.x.x), indem der Datenverkehr über den Host geroutet wird:

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

Ursache 1: Konflikte mit virtuellen Netzwerkadaptern (VPN / Tailscale)

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

Die VPN-Netzwerke des Hosts können die Erstellung der WSL-Netzwerkspiegelbrücke abfangen.

  • Lösung: Stoppen Sie vorübergehend den VPN-Dienst unter Windows. Wenn Sie Dienste auf Ihrem Linux-Rechner verwenden, stellen Sie sicher, dass Sie diese vor dem Herunterfahren suspendieren:
    Ventana de terminal
    sudo systemctl stop tailscaled
    Und starten Sie die Umgebung über CMD neu: wsl --shutdown.

Wenn die Netzwerkbrücke den virtuellen Adapter nach einem Windows-Update nicht startet:

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

Ursache 3: Blockierung des eingehenden Datenverkehrs durch die Windows-Firewall

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

Die Windows Defender Firewall blockiert standardmäßig nicht erkannte eingehende Verbindungen vom virtuellen WSL-Adapter. Aktivieren Sie eine dedizierte Zulassungsregel:

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

Ausführen über PowerShell / CMD mit erhöhten Rechten:

ZielBefehl
Distros auflisten und Version überprüfen (v1 oder v2)wsl --list --verbose
Direkter Zugriff mit Root-Privilegienwsl -d kali-linux --user root
Hängende NAT-Dienste lösennet stop winnat; net start winnat
Hypervisor zwangsweise ausschaltenwsl --shutdown
Routing-Tabelle unter Linux auditierenip a oder ip route

6. Checkliste für Validierung und Erfolg

Sección titulada «6. Checklist de Validación y Éxito»
  • ✓ Stabilität: Der Befehl wsl initialisiert die Shell in weniger als 2 Sekunden.
  • ✓ Aktiver Spiegel: ip a unter Linux spiegelt dieselbe physische IP des WiFi/Ethernet-Netzwerks von Windows.
  • ✓ Synchronisation: Keine Netzwerk-Kollisionen nach der kontrollierten Deaktivierung des Tailscale-Treibers.