Ir al contenido

Diagnosi e Configurazione Avanzata di WSL2

Risoluzione dei problemi di blocco di LxssManager, aggiornamento del kernel e configurazione avanzata della rete specchiata (Mirrored) in WSL2.

0letture

Questa guida tecnica compila le procedure avanzate di diagnostica, riparazione e configurazione del sistema di rete per il Sottosistema di Windows per Linux (WSL2). Si concentra sulla risoluzione del blocco infinito dei processi (LxssManager), sulla transizione alla versione moderna del negozio e sull'ottimizzazione del routing mediante la modalità di rete specchiata (Mirrored).


Quando si tenta di eseguire wsl o wsl -d <distro>, la console lampeggia ed entra in uno stato di sospensione continua senza caricare la shell. Quando si tenta di forzare l'interruzione con wsl --shutdown, il terminale si congela indefinitamente sull'istruzione “Deteniendo…”.

Fase 1: Tentativo di Arresto Controllato (Soft Kill)

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

Esegui l'arresto nativo del sottosistema tramite il Prompt dei Comandi (CMD):

Ventana de terminal
wsl --shutdown

Fase 2: Arresto Forzato di Thread e Processi (Hard Kill)

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

Se lo spegnimento graduale non risponde, è obbligatorio terminare i sottoprocessi della macchina virtuale dell'hypervisor (vmmem) e i gestori dei thread dell'host. Apri PowerShell come Amministratore ed esegui:

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

Se i comandi precedenti restituiscono un errore di Accesso negato, si è verificato un blocco a livello di driver dovuto a una collisione di porte di rete native (HNS/WinNAT).

La soluzione più rapida e intelligente consiste nel riavviare il servizio NAT di Windows per sbloccare i socket del kernel:

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

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

Per abilitare funzionalità di virtualizzazione avanzate come la modalità Mirrored, è obbligatorio migrare dalla versione di WSL storicamente integrata in Windows (Legacy) alla versione disaccoppiata distribuita tramite il Microsoft Store.

Verifica della versione dello stack di esecuzione

Sección titulada «Comprobar Versión de la Pila de Ejecución»
Ventana de terminal
wsl --version
  • Se viene restituito un messaggio di errore o una sintassi errata: Il sistema opera con la versione di architettura Legacy obsoleta.
  • Se viene stampata una tabella con le versioni del kernel e di WSL: Il sistema opera con la versione del Microsoft Store.

Forza il download diretto del pacchetto aggiornato al di fuori dello store se esistono restrizioni di rete aziendali:

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 di rete: Modalità NAT vs. Specchio (Mirrored)

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

File di configurazione dell'ambiente .wslconfig

Sección titulada «Archivo de Configuración de Entorno .wslconfig»

Per definire la topologia a livello di hardware virtuale, crea il file di configurazione globale nella root del tuo profilo utente di Windows:

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

Estensione del file

Assicurati che il tuo File Explorer non aggiunga in modo invisibile l'estensione .txt alla fine. Se viene creata come .wslconfig.txt, il motore WSL ignorerà completamente la direttiva. Puoi correggerlo con PowerShell:

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

Configurazione A: Modalità Specchio (Mirrored) - Consigliata

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

Copia le interfacce e gli indirizzi IP della tua macchina Windows direttamente all'interno della tua macchina virtuale Linux. È la configurazione standard d'eccellenza per gli audit di rete, il pentesting e il deployment di microservizi:

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

Configurazione B: Modalità NAT Classica

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

Mantiene la macchina virtuale isolata all'interno di una propria sottorete virtuale indipendente (tipicamente 172.x.x.x), instradando il traffico attraverso l'host:

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

4. Risoluzione dei problemi di perdita di connettività

Sección titulada «4. Resolución de Incidencias de Pérdida de Conectividad»

Causa 1: Conflitti con adattatori di rete virtuali (VPN / Tailscale)

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

Le reti VPN dell'host possono intercettare la creazione del bridge di rete specchio di WSL.

  • Soluzione: Fermare momentaneamente il servizio VPN in Windows. Se si utilizzano servizi sulla macchina Linux, assicurarsi di sospenderli prima di spegnere:
    Ventana de terminal
    sudo systemctl stop tailscaled
    E riavviare l'ambiente da CMD: wsl --shutdown.

Se il bridge di rete non avvia l'adattatore virtuale dopo un aggiornamento di Windows:

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

Causa 3: Blocco del traffico in entrata da parte del Firewall di Windows

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

Il Firewall di Windows Defender blocca per impostazione predefinita le connessioni in entrata non riconosciute provenienti dall'adattatore virtuale di WSL. Abilita una regola permissiva dedicata:

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

5. Cheat Sheet: Comandi operativi di emergenza

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

Eseguire da PowerShell / CMD con privilegi elevati:

ObiettivoComando
Elencare le distro e verificare la versione (v1 o v2)wsl --list --verbose
Accedere direttamente con privilegi di rootwsl -d kali-linux --user root
Liberare i blocchi del servizio NATnet stop winnat; net start winnat
Spegnere forzatamente l'hypervisorwsl --shutdown
Auditare la tabella di indirizzamento in Linuxip a o ip route

  • ✓ Stabilità: Il comando wsl inizializza la shell in meno di 2 secondi.
  • ✓ Specchio Attivo: ip a all'interno di Linux riflette la stessa IP fisica della rete WiFi/Ethernet di Windows.
  • ✓ Sincronizzazione: Nessuna collisione di rete dopo la disattivazione controllata del driver di Tailscale.