Skip to content

Services LAN prêts à l'emploi au démarrage de Windows ​

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 :

  1. WSL utilise le mode réseau NAT par défaut (si le mode miroir 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) ;
  2. Le service à partager écoute sur 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).

1. Configuration en deux étapes ​

Étape 1 : Démarrage de la distribution avec Windows et lancement automatique des services métier ​

Dans la liste des distributions Linux installées, cliquez sur le bouton « Paramètres » de la distribution cible :

  1. Cochez « Démarrer automatiquement cette distribution au démarrage de Windows. » — l'environnement Linux démarre avec Windows ;
  2. Dans « Exécuter un script après le démarrage de la distribution (optionnel) », saisissez le chemin absolu du script de démarrage (par exemple /home/dev/init-services.sh) — pour que MySQL, Redis et d'autres services démarrent avec Linux ;
  3. Cliquez sur Enregistrer.

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 :

bash
#!/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.

Étape 2 : Ajouter des règles de redirection de ports ​

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 » :

ChampValeur d'exempleDescription
Distribution cibleUbuntuDistribution dans laquelle le service s'exécute réellement
IP d'écoute0.0.0.0Accessible depuis le réseau local ; si vous saisissez 127.0.0.1, seule la machine locale peut y accéder
Port d'écoute3306Port exposé vers l'extérieur côté Windows
Port cible3306Port sur lequel le service écoute à l'intérieur de la distribution ; peut différer du port d'écoute
Ajouter une règle de pare-feuCoché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.

Critères de réussite ​

  • Dans les paramètres de la distribution, « Démarrer automatiquement cette distribution au démarrage de Windows. » est coché ;
  • Dans la liste de redirection de ports, les règles apparaissent comme appliquées ;
  • Après un redémarrage de Windows, les services sont toujours accessibles depuis une autre machine du réseau local.

2. Vérifier que cela fonctionne (facultatif) ​

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 ?

powershell
Test-NetConnection 127.0.0.1 -Port 3306

Si 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 ?

powershell
Test-NetConnection 192.168.1.10 -Port 3306

Si 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

bash
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

powershell
netsh interface portproxy show all

Sortie 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

3. Problèmes courants en un coup d'œil ​

SymptômeCause la plus probableSolution
Il faut attendre quelques minutes après le démarrage pour pouvoir accéder aux servicesSur 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émarrageLa distribution n'a pas démarré avec Windows et la synchronisation des règles a été ignoréeVé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 localL'IP d'écoute est 127.0.0.1, ou la règle de pare-feu n'est pas cochéePassez la règle à 0.0.0.0 et appliquez-la à nouveau
Ne fonctionne pas non plus en localLe service écoute uniquement sur 127.0.0.1, ou il n'a pas démarré du toutModifiez 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 adressewsl --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'écouteIdentifiez-le avec netstat -ano | findstr :3306, puis choisissez un autre port d'écoute
L'élévation de privilèges a été refuséeL'invite d'autorisation Windows a été refusée lors de l'enregistrement des paramètres ou de l'application des règlesEnregistrez à nouveau les paramètres et autorisez l'accès