Diagnostyka i zaawansowana konfiguracja WSL2
Rozwiązywanie incydentów blokowania LxssManager, aktualizacja jądra i zaawansowana konfiguracja sieci lustrzanej (Mirrored) w WSL2.
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»Objaw techniczny
Sección titulada «Síntoma Técnico»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):
wsl --shutdownFaza 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:
taskkill /f /fi "imagename eq wsl*"taskkill /f /im vmmemtaskkill /f /im wslhost.exetaskkill /f /im conhost.exeFaza 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:
# 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. 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.
Sprawdź wersję stosu wykonawczego
Sección titulada «Comprobar Versión de la Pila de Ejecución»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.
Przepływ aktualizacji ręcznej
Sección titulada «Flujo de Actualización Manual»Wymuś bezpośrednie pobranie zaktualizowanego pakietu poza sklepem, jeśli istnieją ograniczenia sieciowe:
# 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. Topologia sieci: tryb NAT a lustrzany (Mirrored)
Sección titulada «3. Topología de Red: Modo NAT vs. Espejo (Mirrored)»Plik konfiguracyjny środowiska .wslconfig
Sección titulada «Archivo de Configuración de Entorno .wslconfig»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 obligatoriaC:\Users\usuario.demo\.wslconfigRozszerzenie 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:
Rename-Item -Path "C:\Users\usuario.demo\.wslconfig.txt" -NewName ".wslconfig" -ForceKonfiguracja 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:
[wsl2]networkingMode=mirroreddnsTunneling=trueautoProxy=truefirewall=trueKonfiguracja B: klasyczny tryb NAT
Sección titulada «Configuración B: Modo NAT Clásico»Utrzymuje maszynę wirtualną w izolacji w ramach własnej, niezależnej podsieci wirtualnej (zwykle 172.x.x.x), przekazując ruch przez hosta:
[wsl2]networkingMode=nat4. Rozwiązywanie problemów z utratą łączności
Sección titulada «4. Resolución de Incidencias de Pérdida de Conectividad»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:
Y reinicia el entorno desde CMD:
Ventana de terminal sudo systemctl stop tailscaledwsl --shutdown.
Przyczyna 2: uszkodzenie gniazd Winsock
Sección titulada «Causa 2: Corrupción en los Sockets de Winsock»Jeśli mostek sieciowy nie podnosi adaptera wirtualnego po aktualizacji systemu Windows:
# Ejecutar en PowerShell como Administrador y reiniciar el PCnetsh int ip resetnetsh winsock resetPrzyczyna 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ą:
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:
| Cel | Polecenie |
|---|---|
| Wyświetlanie listy dystrybucji i weryfikacja wersji (v1 lub v2) | wsl --list --verbose |
| Bezpośredni dostęp z uprawnieniami root | wsl -d kali-linux --user root |
| Zwolnienie zawieszenia usługi NAT | net stop winnat; net start winnat |
| Wymuszone wyłączenie hipernadzorcy | wsl --shutdown |
| Audyt tabela routingu w systemie Linux | ip a lub ip route |
6. Lista kontrolna walidacji i powodzenia
Sección titulada «6. Checklist de Validación y Éxito»- ✓ Stabilność: Polecenie
wslinicjuje powłokę w czasie krótszym niż 2 sekundy. - ✓ Aktywne lustrzane odbicie:
ip aw systemie Linux odzwierciedla tę samą fizyczną IP sieci WiFi/Ethernet systemu Windows. - ✓ Synchronizacja: Brak kolizji sieci po kontrolowanym wyłączeniu sterownika Tailscale.

