Français
Appearance
Français
Appearance
Exposez n'importe quel service de WSL — MySQL (3306), Redis (6379), Nginx (80), etc. — aux collègues de votre réseau local et faites en sorte que les services soient automatiquement prêts dès le démarrage de Windows : sans ouvrir de session sur le bureau, sans terminal, sans mémoriser de commandes et sans reconfigurer après chaque redémarrage.
La configuration complète ne demande que deux étapes, et une seule fois ; ensuite, à chaque démarrage, l'application lance Linux, les services métier et la redirection de ports dans l'ordre.
Avant de commencer, vérifiez deux petits points :
networkingMode=mirrored est activé, la redirection de ports n'est pas nécessaire : accédez directement aux services via l'IP de l'hôte) ;0.0.0.0 et non sur 127.0.0.1 (un piège fréquent avec bind-address de MySQL et bind de Redis).Dans la liste des distributions Linux installées, cliquez sur le bouton « Paramètres » de la distribution cible :
/home/dev/init-services.sh) — pour que MySQL, Redis et d'autres services démarrent avec Linux ;Le script doit remplir ces conditions : le fichier doit réellement exister, disposer du droit d'exécution (chmod +x) et ne pas utiliser un chemin réservé du système. Le script s'exécute en arrière-plan avec l'identité root. Pour son écriture et des exemples, voir Démarrage automatique des services dans la distribution. Voici un exemple minimal fonctionnel :
#!/bin/bash
# /home/dev/init-services.sh
LOG_FILE="/var/log/wsl-services.log"
echo "$(date): boot hook start" >> "$LOG_FILE"
service mysql start >> "$LOG_FILE" 2>&1
service redis-server start >> "$LOG_FILE" 2>&1
nginx >> "$LOG_FILE" 2>&1
echo "$(date): boot hook done" >> "$LOG_FILE"TIP
La sortie du script de démarrage est ignorée par défaut, c'est pourquoi l'exemple écrit dans un fichier journal. Pour vérifier ensuite « si le service a réellement démarré », consulter ce journal est le moyen le plus direct.
Revenez à « Réseau » → « Redirection de ports », cliquez sur « Ajouter une règle » et remplissez la fenêtre « Ajouter une règle de redirection de ports » :
| Champ | Valeur d'exemple | Description |
|---|---|---|
| Distribution cible | Ubuntu | Distribution dans laquelle le service s'exécute réellement |
| IP d'écoute | 0.0.0.0 | Accessible depuis le réseau local ; si vous saisissez 127.0.0.1, seule la machine locale peut y accéder |
| Port d'écoute | 3306 | Port exposé vers l'extérieur côté Windows |
| Port cible | 3306 | Port sur lequel le service écoute à l'intérieur de la distribution ; peut différer du port d'écoute |
| Ajouter une règle de pare-feu | Coché | Autorise automatiquement le trafic entrant ; sinon, les connexions depuis le réseau local seront bloquées |
Ajoutez une autre règle 6379 → 6379 pour Redis. Une fois les règles ajoutées, cliquez sur « Appliquer la règle » sur cette ligne, ou directement sur « Appliquer toutes les règles » en bas (une seule élévation de privilèges suffit pour appliquer toutes les règles).
IMPORTANT
Le port d'écoute ne doit pas entrer en conflit avec un programme déjà présent sur Windows. Si MySQL est déjà installé sur la machine Windows et occupe 3306, vous pouvez changer le port d'écoute en 13306 et conserver 3306 comme port cible ; les utilisateurs du réseau local pourront alors se connecter à 192.168.1.10:13306.
Il est conseillé de vérifier dans l'ordre « machine locale → réseau local → client » ; chaque étape indique immédiatement à quel niveau se situe le problème.
① Machine Windows : le service tourne-t-il réellement dans WSL ?
Test-NetConnection 127.0.0.1 -Port 3306Si le test échoue, le problème se situe à l'intérieur de WSL (service non démarré, écoute uniquement sur 127.0.0.1, ports incohérents) et n'a rien à voir avec les règles de redirection.
② Une autre machine du réseau local : la redirection et le pare-feu autorisent-ils le passage ?
Test-NetConnection 192.168.1.10 -Port 3306Si cela fonctionne en local mais pas sur le réseau local, il manque généralement une règle de pare-feu, l'IP d'écoute n'est pas 0.0.0.0, ou les deux machines ne sont pas sur le même sous-réseau.
③ Se connecter avec un vrai client
mysql -h 192.168.1.10 -P 3306 -u <utilisateur> -p
redis-cli -h 192.168.1.10 -p 6379④ Afficher les règles de redirection actuellement actives
netsh interface portproxy show allSortie attendue (l'adresse sous Connect to ipv4 à droite est l'IP actuelle de la distribution WSL ; elle change après un redémarrage) :
Listen on ipv4: Connect to ipv4:
Address Port Address Port
--------------- ---------- --------------- ----------
0.0.0.0 6379 172.28.78.41 6379
0.0.0.0 3306 172.28.78.41 3306| Symptôme | Cause la plus probable | Solution |
|---|---|---|
| Il faut attendre quelques minutes après le démarrage pour pouvoir accéder aux services | Sur certaines machines, la machine virtuelle WSL démarre à froid très lentement (voir #125) | Patientez quelques minutes ; le processus automatisé se terminera de lui-même, sans intervention manuelle |
| Impossible de se connecter depuis le réseau local après un redémarrage | La distribution n'a pas démarré avec Windows et la synchronisation des règles a été ignorée | Vérifiez que l'étape 1 est cochée ; cliquez à nouveau sur « Appliquer toutes les règles » |
| Fonctionne en local mais pas sur le réseau local | L'IP d'écoute est 127.0.0.1, ou la règle de pare-feu n'est pas cochée | Passez la règle à 0.0.0.0 et appliquez-la à nouveau |
| Ne fonctionne pas non plus en local | Le service écoute uniquement sur 127.0.0.1, ou il n'a pas démarré du tout | Modifiez l'adresse d'écoute du service ; consultez le journal du script de démarrage |
| La règle est appliquée mais la connexion aboutit encore à l'ancienne adresse | wsl --shutdown a été exécuté manuellement et l'IP a changé | Cliquez à nouveau sur « Appliquer toutes les règles » |
| Le port est déjà utilisé | Un programme Windows occupe le même port d'écoute | Identifiez-le avec netstat -ano | findstr :3306, puis choisissez un autre port d'écoute |
| L'élévation de privilèges a été refusée | L'invite d'autorisation Windows a été refusée lors de l'enregistrement des paramètres ou de l'application des règles | Enregistrez à nouveau les paramètres et autorisez l'accès |