Netzwerkeinstellungen

WSL Dashboard vereinfacht die Konfiguration der Netzwerkkommunikation zwischen WSL 2 und dem Host (Windows) und unterstützt Portweiterleitung und globalen HTTP-Proxy.

Portweiterleitung (Port Forwarding)

Da WSL 2 einen virtuellen Netzwerkadapter verwendet, ist der Zugriff auf WSL-interne Dienste von anderen Geräten im lokalen Netzwerk oft kompliziert.

• Kernfunktion: Sie können bestimmte Windows-Ports auf interne Ports der WSL-Instanz mappen.
• Automatische Firewall-Regeln: Beim Erstellen einer Weiterleitungsregel fügt WSL Dashboard automatisch die erforderlichen eingehenden Regeln zur Windows-Defender-Firewall hinzu, damit externer Datenverkehr durchgelassen wird.
• Konfigurationsoptionen:
  • Host-IP: In der Regel 0.0.0.0 (lauscht auf allen Netzwerkkarten) oder 127.0.0.1.
  • Host-Port: Der auf der Windows-Seite geöffnete Port.
  • WSL-Port: Der Port, auf dem der interne Dienst der Instanz lauscht.

Globaler HTTP-Proxy (HTTP Proxy)

Das Konfigurieren eines Proxys innerhalb von WSL (z. B. wenn git clone oder apt install langsam sind) erfordert normalerweise das Ändern mehrerer Konfigurationsdateien.

• Schnelle Konfiguration: WSL Dashboard bietet einen globalen Proxy-Schalter.
• Funktionsweise: Es konfiguriert automatisch die Proxy-Umgebungsvariablen oder die Proxy-Optionen der entsprechenden Dienste in der ausgewählten Instanz, sodass Sie sich das manuelle Ermitteln der Host-IP ersparen.
• Unterstützte Protokolle: die gängigen Protokolle http:// und socks5://.

Netzwerkstatus-Überwachung

Im Netzwerk-Panel können Sie in Echtzeit sehen:

• WSL-Host-IP: die IP des virtuellen Netzwerkadapters von Windows.
• WSL-Instanz-IP: die tatsächlich in der Instanz vergebene Adresse.
• Aktive Verbindungen: überwacht die aktuell gültigen Portweiterleitungsregeln und den Datenverkehrsstatus.

Erweiterter Netzwerkmodus (Mirrored Mode)

Für Windows-11-Benutzer unterstützt WSL 2 den „Mirrored"-Netzwerkmodus.

• Vorteile: Der Mirrored-Modus erlaubt es der WSL-Instanz, die Netzwerkschnittstelle des Hosts direkt zu teilen und löst viele komplexe VPN- oder LAN-Erkennungsprobleme.
• Konfigurationsempfehlung: Wenn Sie den Mirrored-Modus aktiviert haben, funktioniert die Portweiterleitung von WSL Dashboard weiterhin, aber Sie bevorzugen möglicherweise den direkten Zugriff auf Dienste über die Host-IP.

Tipp

Das Setzen von auto_shutdown_distros = true in settings.toml stellt sicher, dass nach dem Schließen des Dashboards keine unnötigen Netzwerk-Listener-Aufgaben im Hintergrund verbleiben.

Behebung häufiger Probleme

Portkonflikt

Wenn eine Portweiterleitung nicht greift, prüfen Sie:

1. Ist der Host-Port belegt?: Verwenden Sie netstat -ano | findstr :<Portnummer>.
2. Administratorrechte: Manche Ports (z. B. unter 1024) erfordern möglicherweise Administratorrechte zum Lauschen.

Firewall-Blockierung

Obwohl WSL Dashboard versucht, Regeln automatisch zu konfigurieren, müssen Sie bei einer installierten Fremd-Firewall (z. B. Huorong, 360 usw.) möglicherweise den Netzwerkzugriff von wsldashboard.exe manuell erlauben.