WSL mirrored Netzwerkmodus-Konfigurationsanleitung

WSL 2.6.0 Netzwerkmodus-Upgrade-Konfigurationsanleitung
Tags:
Categories:

Versionsanforderungen

Aktueller Versionsstatus:

  • Neueste stabile Version: 2.5.9 (weist Netzwerkkonfigurationsmängel auf)
  • Empfohlene Version: 2.6.0 Vorabversion (unterstützt vollständigen mirrored-Modus)

Modus-Vergleichsanalyse

Merkmal bridge-Modus (veraltet) mirrored-Modus (empfohlen)
Protokollstapelarchitektur Doppelstapel Gemeinsamer Stapel
IP-Adresszuweisung Eigenständige IP (Windows+WSL) Gemeinsame Host-IP
Portressourcen Eigenständige Nutzung Gemeinsame Ports (Konflikte vermeiden)
Netzwerkleistung Relativ aufwändig Leichtgewichtig und effizient
Konfigurationskomplexität Einfach Erfordert tiefgreifende Firewall-Strategiekonfiguration

Standardkonfigurationsschritte

1. Netzwerkmoduseinstellung

Über die WSL Settings App Basismodus festlegen:

  1. Einstellungs-App öffnen
  2. Reiter “Network” auswählen
  3. Netzwerkmodus auf “Mirrored” setzen
  4. Konfiguration übernehmen und WSL neu starten

2. Firewall-Strategiekonfiguration

Muss über PowerShell vollständige Strategiekonfiguration ausgeführt werden:

# WSL-VM-GUID definieren
$wslGuid = '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}'

# Firewall-Strategie konfigurieren (in Reihenfolge ausführen)
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

# Konfigurationsergebnis prüfen
Get-NetFirewallHyperVVMSetting -Name $wslGuid

3. Port-Mapping-Verifikation

# Beispiel: Überprüfung der Belegung des Ports 80
Get-NetTCPConnection -LocalPort 80

Häufige Problembehandlung

Problem 1: Externe Verbindung kann nicht hergestellt werden

  • Prüfschritte: Alle Felder in der Ausgabe von Get-NetFirewallHyperVVMSetting sollten True/Allow sein
  • Lösungsansatz: Firewall-Strategiekonfiguration in Reihenfolge erneut ausführen

Problem 2: Port-Konflikte

  • Überprüfungsmethode: netstat -ano zeigt Portbelegung an
  • Behandlungsempfehlung: Belegte Ports auf Windows-Seite vorrangig freigeben oder WSL-Dienst-Listenports ändern

Verifizierungsmethode

  1. WSL-Dienst starten (z.B. Nginx/Apache)
  2. Von Windows-Host aus auf http://localhost:<port> zugreifen
  3. Von lokalen Netzwerkgeräten auf http://<host-ip>:<port> zugreifen

Referenzmaterialien

  1. Offizielles WSL-Netzwerkdokument
  2. WSL 2.6.0 Veröffentlichungshinweise