Skip to content

Netzwerkeinstellungen

WSL Dashboard vereinfacht die Konfiguration der Netzwerkkommunikation zwischen WSL 2 und dem Host (Windows), mit Unterstützung für Port-Forwarding und globalen HTTP-Proxy.

Port-Forwarding

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

  • Kernfunktion: Sie können bestimmte Windows-Ports auf Ports innerhalb der WSL-Instanz abbilden.
  • Automatische Firewall-Regeln: WSL Dashboard fügt beim Erstellen von Forwarding-Regeln automatisch die notwendigen eingehenden Regeln in der Windows Defender Firewall hinzu, um sicherzustellen, dass externer Traffic durchdringen kann.
  • Einstellungen:
    • Host-IP: Normalerweise 0.0.0.0 (Anhörung auf allen Netzwerkkarten) oder 127.0.0.1.
    • Host-Port: Auf der Windows-Seite geöffneter Port.
    • WSL-Port: Port, auf dem der interne Dienst der Instanz lauscht.

Globaler HTTP-Proxy

Die Konfiguration eines Proxys innerhalb von WSL (z. B. bei langsamen git clone oder apt install) erfordert normalerweise die Änderung mehrerer Konfigurationsdateien.

  • Schnellkonfiguration: WSL Dashboard bietet einen globalen Proxy-Schalter.
  • Funktionsweise: Basierend auf Ihren Einstellungen konfiguriert es automatisch Proxy-Umgebungsvariablen oder Proxy-Optionen für relevante Dienste in der ausgewählten Instanz, ohne dass Sie manuell die Host-IP abrufen müssen.
  • Unterstützte Protokolle: Gängige http:// und socks5:// Protokolle.

Netzwerkstatus-Monitoring

Sie können im Netzwerk-Panel in Echtzeit anzeigen:

  • WSL-Host-IP: IP des virtuellen Netzwerkadapters von Windows.
  • WSL-Instanz-IP: Tatsächliche zugewiesene Adresse innerhalb der Instanz.
  • Aktive Verbindungen: Überwachung der aktuell gültigen Port-Forwarding-Regeln und des Traffic-Status.

Erweiterter Netzwerkmodus (Mirror-Modus)

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

  • Vorteil: Der Mirror-Modus ermöglicht es der WSL-Instanz, direkt die Netzwerkschnittstelle des Hosts zu teilen, was viele komplexe VPN- oder Lokales-Netzwerk-Erkennungsprobleme löst.
  • Konfigurationsempfehlung: Wenn Sie den Mirror-Modus aktiviert haben, funktioniert die Port-Forwarding-Funktion von WSL Dashboard weiterhin, aber Sie bevorzugen möglicherweise den direkten Zugriff auf Dienste über die Host-IP.

Tipp

Die Konfiguration von auto_shutdown_distros = true in settings.toml kann sicherstellen, dass nach dem Schließen von Dashboard keine unnötigen Netzwerk-Listener-Tasks im Hintergrund verbleiben.

Häufige Problembehebung

Port-Konflikt

Wenn eine Port-Forwarding-Regel nicht funktioniert, überprüfen Sie:

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

Firewall-Blockierung

Obwohl WSL Dashboard versucht, Regeln automatisch zu konfigurieren, müssen Sie möglicherweise manuell den Netzwerkzugriff für wsldashboard.exe erlauben, wenn Sie eine Drittanbieter-Firewall installiert haben (z. B. Huorong, 360, etc.).