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éristiques Mode bridge (obsolète) Mode miroir (recommandé)
Architecture de pile de protocole Double pile Pile partagée
Attribution d’adresses IP IP indépendante (Windows+WSL) IP hôte partagée
Ressources de port Utilisation indépendante Ports partagés (éviter les conflits)
Performance réseau Relativement lourde Légère et efficace
Complexité de configuration Simple Configuration 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