Ir al contenido

Diagnostyka i zaawansowana konfiguracja WSL2

Rozwiązywanie incydentów blokowania LxssManager, aktualizacja jądra i zaawansowana konfiguracja sieci lustrzanej (Mirrored) w WSL2.

0odwiedzin

Ten techniczny przewodnik kompiluje zaawansowane procedury diagnostyczne, naprawcze i konfiguracyjne systemu sieciowego dla Subsystemu Windows dla Linux (WSL2). Koncentruje się na rozwiązywaniu niekończącego się blokowania procesów, przejściu do nowoczesnej wersji sklepu oraz optymalizacji routingu za pomocą trybu sieci lustrzanej (Mirrored)


1. Diagnostyka nieskończonego blokowania WSL

Sección titulada «1. Diagnóstico del Bloqueo Infinito de WSL»

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…”.

Faza 1: Próba kontrolowanego zatrzymania (miękkie zabicie)

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

Wykonaj natywne zatrzymanie podsystemu za pomocą wiersza poleceń (CMD):

Ventana de terminal
wsl --shutdown

Faza 2: Wymuszone zatrzymanie wątków i procesów (twarde zabicie)

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

Jeśli zatrzymanie miękkie nie odpowiada, jest wymagane zakończenie subprocesów maszyny wirtualnej hipervizora (vmmem) oraz menedżerów wątków hosta. Otwórz PowerShell jako Administrator i wykonaj:

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

Faza 3: Zwolnienie blokady jądra (LxssManager Hang)

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

Jeśli poprzednie polecenia zwracają błąd Odmowa Dostępu, nastąpił zablokowanie na poziomie sterownika z powodu kolizji portów sieciowych natywnych (HNS/WinNAT).

Najszybszym i najinteligentniejszym rozwiązaniem jest ponowne uruchomienie usługi NAT systemu Windows, aby odblokować gniazda jądra:

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. Aktualizacja WSL (starsza wersja a sklep Microsoftu)

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

Aby włączyć zaawansowane funkcje wirtualizacji, takie jak tryb Mirrored, jest wymagana migracja z wersji WSL zintegrowanej historycznie z systemem Windows (Legacy) do wersji wydzielonej dystrybuowanej przez Microsoft Store.

Ventana de terminal
wsl --version
  • Jeśli zwraca komunikat o błędzie lub niepoprawnej składni: System działa pod wersją architektury Legacy przestarzałą.
  • Jeśli drukuje tabelę z wersjami jądra i WSL: System działa pod wersją Microsoft Store.

Wymuś bezpośrednie pobranie zaktualizowanego pakietu poza sklepem, jeśli istnieją ograniczenia sieciowe:

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. Topologia sieci: tryb NAT a lustrzany (Mirrored)

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

Aby zdefiniować topologię na poziomie wirtualnego sprzętu, utwórz plik konfiguracji globalnej w katalogu głównym Twojego profilu użytkownika systemu Windows:

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

Rozszerzenie pliku

Upewnij się, że Twój menedżer plików nie dodaje niewidocznie rozszerzenia .txt na końcu. Jeśli zostanie utworzony jako .wslconfig.txt, silnik WSL całkowicie zignoruje dyrektywę. Możesz to poprawić za pomocą programu PowerShell:

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

Konfiguracja A: tryb lustrzany (Mirrored) - zalecana

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

Kopiuj interfejsy i adresy IP Twojej maszyny z systemem Windows bezpośrednio do maszyny wirtualnej Linux. Jest to standardowa konfiguracja doskonałości dla audytów sieciowych, pentestingu i wdrożenia mikroserwisów:

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

Utrzymuje maszynę wirtualną w izolacji w ramach własnej, niezależnej podsieci wirtualnej (zwykle 172.x.x.x), przekazując ruch przez hosta:

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

Przyczyna 1: konflikty z adapterami sieci wirtualnych (VPN / Tailscale)

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

Sieci VPN hosta mogą przechwytywać tworzenie mostka sieciowego 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.

Jeśli mostek sieciowy nie podnosi adaptera wirtualnego po aktualizacji systemu Windows:

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

Przyczyna 3: blokowanie ruchu przychodzącego przez zaporę systemu Windows

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

Zapora systemu Windows Defender blokuje domyślnie nieznane połączenia przychodzące z adaptera wirtualnego WSL. Włącz regułę permisyjną:

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

5. Arkusz ściągający: polecenia operacyjne ratunkowe

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

Wykonaj z poziomu PowerShell / CMD z uprawnieniami podwyższonymi:

CelPolecenie
Wyświetlanie listy dystrybucji i weryfikacja wersji (v1 lub v2)wsl --list --verbose
Bezpośredni dostęp z uprawnieniami rootwsl -d kali-linux --user root
Zwolnienie zawieszenia usługi NATnet stop winnat; net start winnat
Wymuszone wyłączenie hipernadzorcywsl --shutdown
Audyt tabela routingu w systemie Linuxip a lub ip route

6. Lista kontrolna walidacji i powodzenia

Sección titulada «6. Checklist de Validación y Éxito»
  • ✓ Stabilność: Polecenie wsl inicjuje powłokę w czasie krótszym niż 2 sekundy.
  • ✓ Aktywne lustrzane odbicie: ip a w systemie Linux odzwierciedla tę samą fizyczną IP sieci WiFi/Ethernet systemu Windows.
  • ✓ Synchronizacja: Brak kolizji sieci po kontrolowanym wyłączeniu sterownika Tailscale.