Guida alla configurazione della modalità di rete mirrored di WSL

Guida alla configurazione della modalità di rete WSL 2.6.0

Wednesday, June 25, 2025

Requisiti di versione

Stato versione corrente:

Versione stabile più recente: 2.5.9 (presenta difetti di configurazione di rete)
Versione consigliata: versione 2.6.0 Preview (supporta modalità mirrored completa)

Analisi comparativa delle modalità

Caratteristiche	Modalità bridge (deprecata)	Modalità mirrored (consigliata)
Architettura stack protocollo	Doppio stack	Stack condiviso
Assegnazione indirizzi IP	IP indipendente (Windows+WSL)	IP host condiviso
Risorse porta	Uso indipendente	Porta condivisa (da evitare conflitti)
Prestazioni di rete	Relativamente pesante	Leggero ed efficiente
Complessità configurazione	Semplice	Richiede configurazione approfondita strategia firewall

Procedura configurazione standard

1. Impostazione modalità rete

Impostare modalità base tramite applicazione WSL Settings:

Aprire applicazione impostazioni
Selezionare scheda “Network”
Impostare modalità di rete su “Mirrored”
Applicare configurazione e riavviare WSL

2. Configurazione strategia firewall

Richiede esecuzione strategia configurazione completa tramite PowerShell:

# Definire GUID macchina virtuale WSL
$wslGuid = '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}'

# Configurare strategia firewall (eseguire in ordine)
Set-NetFirewallHyperVVMSetting -Name $wslGuid -Enabled True
Set-NetFirewallHyperVVMSetting -Name $wslGuid -DefaultInboundAction Allow
Set-NetFirewallHyperVVMSetting -Name $wslGuid -DefaultOutboundAction Allow
Set-NetFirewallHyperVVMSetting -Name $wslGuid -LoopbackEnabled True
Set-NetFirewallHyperVVMSetting -Name $wslGuid -AllowHostPolicyMerge True

# Verificare risultati configurazione
Get-NetFirewallHyperVVMSetting -Name $wslGuid

3. Verifica mappatura porta

# Esempio: controllare stato occupazione porta 80
Get-NetTCPConnection -LocalPort 80

Gestione problemi comuni

Problema 1: Impossibile stabilire connessione esterna

Passaggi verifica: tutti i campi output Get-NetFirewallHyperVVMSetting dovrebbero essere True/Allow
Soluzione: rieseguire configurazione strategia firewall in ordine

Problema 2: Conflitto porte

Metodo verifica: netstat -ano controllare occupazione porta
Suggerimento gestione: rilasciare prioritariamente porta occupata lato Windows, oppure modificare porta ascolto servizio WSL

Metodo verifica

Avviare servizio WSL (es. Nginx/Apache)
Accedere da host Windows a http://localhost:<port>
Accedere da dispositivo rete locale a http://<host-ip>:<port>