Guide de configuration du mode réseau miroir WSL
Guide de configuration réseau WSL 2.6.0
Categories:
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 :
- Ouvrir l’application de paramètres
- Sélectionner l’onglet “Network”
- Définir le mode réseau sur “Mirrored”
- 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-NetFirewallHyperVVMSettingdoivent ê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 -anopour 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
- Démarrer le service WSL (ex : Nginx/Apache)
- Accéder depuis l’hôte Windows via
http://localhost:<port> - Accéder depuis un appareil du réseau local via
http://<host-ip>:<port>