Skip to content

Configuration réseau

WSL Dashboard simplifie la configuration de la communication réseau entre WSL 2 et l'hôte (Windows), avec prise en charge du transfert de ports et du proxy HTTP global.

Transfert de ports (Port Forwarding)

Étant donné que WSL 2 utilise un adaptateur réseau virtuel, accéder aux services internes WSL à partir d'autres appareils du réseau local est généralement plus complexe.

  • Fonctionnalité core : Vous pouvez mapper des ports spécifiques de Windows vers des ports internes de l'instance WSL.
  • Règles automatiques de pare-feu : WSL Dashboard ajoute automatiquement les règles d'entrée nécessaires dans Windows Defender Firewall lors de la création de règles de transfert, garantissant que le trafic externe peut pénétrer.
  • Configurations :
    • IP de l'hôte : Généralement 0.0.0.0 (écoute sur toutes les cartes réseau) ou 127.0.0.1.
    • Port de l'hôte : Port ouvert côté Windows.
    • Port WSL : Port sur lequel le service interne de l'instance écoute.

Proxy HTTP global (HTTP Proxy)

Configurer un proxy à l'intérieur de WSL (comme lorsque git clone ou apt install sont lents) nécessite généralement de modifier plusieurs fichiers de configuration.

  • Configuration rapide : WSL Dashboard fournit un commutateur de proxy global.
  • Fonctionnement : Selon votre configuration, il configure automatiquement les variables d'environnement de proxy ou les options de proxy pour les services concernés dans l'instance sélectionnée, éliminant le problème d'obtenir manuellement l'IP de l'hôte.
  • Protocoles pris en charge : Protocoles courants http:// et socks5://.

Surveillance de l'état réseau

Vous pouvez voir en temps réel dans le panneau réseau :

  • IP de l'hôte WSL : IP de l'adaptateur réseau virtuel de Windows.
  • IP de l'instance WSL : Adresse réelle assignée à l'intérieur de l'instance.
  • Connexions actives : Surveillance des règles de transfert de ports actuellement actives et de l'état du trafic.

Mode réseau avancé (Mode miroir)

Pour les utilisateurs de Windows 11, WSL 2 prend en charge le mode réseau "miroir" (mirrored).

  • Avantage : Le mode miroir permet à l'instance WSL de partager directement l'interface réseau de l'hôte, résolvant de nombreux problèmes complexes de VPN ou de découverte de réseau local.
  • Conseil de configuration : Si vous avez activé le mode miroir, la fonction de transfert de ports de WSL Dashboard continue de fonctionner, mais vous préférerez peut-être accéder aux services directement via l'IP de l'hôte.

Astuce

Configurer auto_shutdown_distros = true dans settings.toml peut garantir qu'aucune tâche d'écoute réseau inutile ne reste en arrière-plan après la fermeture de Dashboard.

Dépannage courant

Conflit de ports

Si un transfert de port ne fonctionne pas, vérifiez :

  1. Le port hôte est-il occupé ? : Utilisez netstat -ano | findstr :<numéro de port> pour vérifier.
  2. Autorisations d'administrateur : Certains ports (comme ceux inférieurs à 1024) peuvent nécessiter des autorisations d'administrateur pour écouter.

Blocage du pare-feu

Bien que WSL Dashboard tente de configurer automatiquement les règles, si vous avez un pare-feu tiers installé (comme Huorong, 360, etc.), vous devrez peut-être autoriser manuellement l'accès réseau à wsldashboard.exe.