Guide de configuration du mode réseau miroir WSL

Guide de configuration réseau WSL 2.6.0

Exigences de version

État de la version actuelle :

  • Dernière version stable : 2.5.9 (présente des défauts de configuration réseau)
  • Version recommandée : 2.6.0 version Preview (prend en charge le mode miroir complet)

Analyse comparative des modes

CaractéristiquesMode bridge (obsolète)Mode miroir (recommandé)
Architecture de pile de protocoleDouble pilePile partagée
Attribution d’adresses IPIP indépendante (Windows+WSL)IP hôte partagée
Ressources de portUtilisation indépendantePorts partagés (éviter les conflits)
Performance réseauRelativement lourdeLégère et efficace
Complexité de configurationSimpleConfiguration approfondie du pare-feu requise

Étapes de configuration standard

1. Configuration du mode réseau

Configurer le mode de base via l’application WSL Settings :

  1. Ouvrir l’application de paramètres
  2. Sélectionner l’onglet “Network”
  3. Définir le mode réseau sur “Mirrored”
  4. Appliquer la configuration et redémarrer WSL

2. Configuration de la stratégie de pare-feu

Configurer la stratégie complète via PowerShell :

# Définir le GUID de la machine virtuelle WSL
$wslGuid = '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}'

# Configurer la stratégie de pare-feu (exécuter dans l'ordre)
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

# Vérifier les résultats de configuration
Get-NetFirewallHyperVVMSetting -Name $wslGuid

3. Vérification du mappage de port

# Exemple : vérifier l'occupation du port 80
Get-NetTCPConnection -LocalPort 80

Résolution des problèmes courants

Problème 1 : Impossible d’établir une connexion externe

  • Étapes de vérification : Tous les champs de sortie de Get-NetFirewallHyperVVMSetting doivent être True/Allow
  • Solution : Réexécuter la configuration de stratégie de pare-feu dans l’ordre

Problème 2 : Conflit de port

  • Méthode de vérification : netstat -ano pour afficher l’occupation des ports
  • Recommandations : Libérer en priorité les ports occupés par Windows, ou modifier le port d’écoute du service WSL

Méthode de vérification

  1. Démarrer le service WSL (ex : Nginx/Apache)
  2. Accéder depuis l’hôte Windows via http://localhost:<port>
  3. Accéder depuis un appareil du réseau local via http://<host-ip>:<port>

Références

  1. Documentation réseau officielle WSL
  2. Notes de publication WSL 2.6.0