Przewodnik konfiguracji trybu sieciowego mirrored WSL

Przewodnik konfiguracji trybu mirrored WSL2.6.0

Wednesday, June 25, 2025

Wymagania dotyczące wersji

Aktualny stan wersji:

Najnowsza stabilna wersja: 2.5.9 (ma wady konfiguracji sieciowej)
Zalecana wersja: 2.6.0 wersja zapoznawcza (obsługująca pełny tryb mirrored)

Analiza porównawcza trybów

Cechy	Tryb bridge (wycofany)	Tryb mirrored (zalecany)
Architektura stosu protokołu	Podwójny stos	Współdzielony stos
Przydzielanie adresów IP	Niezależne IP (Windows+WSL)	Współdzielenie IP hosta
Zasoby portów	Niezależne użycie	Współdzielone porty (należy unikać konfliktów)
Wydajność sieci	Relatywnie ciężka	Lekka i wydajna
Złożoność konfiguracji	Prosta	Wymaga głębokiej konfiguracji zasad zapory

Standardowe kroki konfiguracji

1. Ustawienia trybu sieciowego

Ustawienia podstawowego trybu za pomocą aplikacji WSL Settings:

Otwórz aplikację ustawień
Wybierz kartę “Network”
Ustaw tryb sieciowy na “Mirrored”
Zastosuj konfigurację i uruchom ponownie WSL

2. Konfiguracja zasad zapory

Należy wykonać pełną konfigurację zasad za pomocą PowerShell:

# Definicja GUID maszyny wirtualnej WSL
$wslGuid = '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}'

# Konfiguracja zasad zapory (wykonywana sekwencyjnie)
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

# Weryfikacja wyników konfiguracji
Get-NetFirewallHyperVVMSetting -Name $wslGuid

3. Weryfikacja mapowania portów

# Przykład: sprawdzanie zajętości portu 80
Get-NetTCPConnection -LocalPort 80

Obsługa typowych problemów

Problem 1: Nie można nawiązać zewnętrznego połączenia

Kroki sprawdzania: wszystkie pola w danych wyjściowych Get-NetFirewallHyperVVMSetting powinny być True/Allow
Rozwiązanie: ponownie wykonaj konfigurację zasad zapory w odpowiedniej kolejności

Problem 2: Konflikt portów

Metoda weryfikacji: netstat -ano sprawdza zajętość portów
Sugestie postępowania: w pierwszej kolejności zwolnij zajęte porty systemu Windows lub zmień port nasłuchujący usługi WSL

Metody weryfikacji

Uruchom usługę WSL (np. Nginx/Apache)
Uzyskaj dostęp z hosta Windows: http://localhost:<port>
Uzyskaj dostęp z urządzenia w sieci LAN: http://<adres-ip-hosta>:<port>