Prévisualiser votre site Docusaurus local sur votre téléphone
Tester une fonctionnalité qui n'existe que sur téléphone (un geste de secousse, une invite d'installation PWA, tout ce qui demande un vrai accéléromètre ou un vrai écran d'accueil) n'oblige pas à déployer d'abord. Le serveur de développement lancé dans le devcontainer de ce blog est déjà accessible depuis un téléphone sur le même Wi-Fi — une adresse IP, un avertissement de certificat à accepter, aucun plugin, aucune nouvelle dépendance. On voit comment trouver l'IP de votre ordinateur, pourquoi ça fonctionne (binding 0.0.0.0, port publié par Docker, pourquoi HTTPS n'est pas négociable), quoi faire quand le réseau empêche les appareils de se voir, et d'où vient réellement cet avertissement de certificat.
Traduction automatique

Tester une fonctionnalité propre au téléphone — un geste de secousse, une invite d'installation PWA, tout ce qui demande un vrai accéléromètre ou un vrai écran d'accueil — donnait l'impression qu'il fallait déployer d'abord, juste pour voir si ça se déclenche. Faux : le serveur de développement déjà lancé dans le devcontainer de ce blog (yarn start --host 0.0.0.0, HTTPS, port 3000 publié par Docker dans compose.yaml) est accessible dès maintenant depuis un téléphone sur le même Wi-Fi — aucun plugin, aucune nouvelle dépendance, aucun déploiement. Trouvez l'IP locale de l'ordinateur (ipconfig sous Windows), ouvrez https://<that-ip>:3000 depuis le navigateur du téléphone, acceptez un avertissement de certificat, et voilà. On voit pourquoi ça marche, quoi faire quand le réseau empêche les appareils de se voir (le partage de connexion du téléphone), et d'où vient réellement cet avertissement de certificat.
Une fonctionnalité qui n'a de sens que sur un téléphone — un geste de secousse comme celui derrière l'easter egg du suricate de ce blog, une vibration haptique, une invite « Ajouter à l'écran d'accueil » — est pénible à valider depuis un portable. La simuler est possible, mais ça prouve que le code tourne, pas que la fonctionnalité marche vraiment sur un vrai téléphone. Le réflexe est de déployer d'abord et de vérifier sur le site réel, ce qui transforme « est-ce que ça marche » en un aller-retour de plusieurs minutes pour chaque micro-ajustement.
Ce n'est pas une fatalité : le serveur de développement qui tourne déjà dans le devcontainer de ce blog était accessible depuis un téléphone sur le même Wi-Fi depuis le début.
Trouvez l'IP de votre ordinateur, puis ouvrez-la
Le téléphone a besoin de l'adresse que votre ordinateur possède sur votre réseau domestique. Elle change d'un réseau à l'autre : le 192.168.0.218 utilisé ci-dessous est seulement l'adresse de l'auteur ; la vôtre y ressemblera (192.168.0.x, 192.168.1.x ou 10.0.0.x sont les formes habituelles).
Sous Windows, ouvrez un terminal Windows (Command Prompt ou PowerShell) — sur Windows lui-même, pas dans un terminal WSL ou devcontainer — et lancez ipconfig :
$ ipconfig Windows IP Configuration Unknown adapter VPN: Media State . . . . . . . . . . . : Media disconnected Connection-specific DNS Suffix . : Ethernet adapter Ethernet 2: Connection-specific DNS Suffix . : IPv6 Address. . . . . . . . . . . : 2001:db8::1417:2921:65be:23c2 IPv4 Address. . . . . . . . . . . : 192.168.0.218
Cherchez l'adaptateur qui affiche une ligne IPv4 Address : Wi-Fi si l'ordinateur est en sans-fil, Ethernet s'il est branché par câble, comme dans l'exemple ci-dessus. Ignorez les adaptateurs marqués Media disconnected, par exemple un VPN inactif, et ignorez 127.0.0.1 ainsi que toute adresse 172.x remontée par WSL ou par les adaptateurs Docker : celles-ci n'ont de sens que pour l'ordinateur lui-même, pas pour un autre appareil du réseau.
Sous macOS, lancez ipconfig getifaddr en0 dans un terminal. Sur un ordinateur sous Linux natif, lancez hostname -I et prenez la première adresse. Ne lancez pas hostname -I dans WSL2 : il renvoie l'adresse du réseau virtuel interne de WSL (une adresse 172.x), que le téléphone ne peut pas joindre. Sous Windows, ipconfig est la commande à utiliser, même quand le devcontainer tourne via WSL2.
Saisissez votre propre adresse dans le champ ci-dessous ; l'URL qui suit se met à jour :
Ensuite, depuis le téléphone — sur le même réseau Wi-Fi — ouvrez cette adresse dans un navigateur, sur le port que le serveur de développement utilise déjà :

Le navigateur signalera d'abord le certificat comme non fiable — c'est attendu, et sans risque ici ; le pourquoi exact est dans Sous le capot plus bas. Passé cet avertissement, c'est bien le vrai serveur de développement : live reload, le HTML réel, et — la raison qui valait la peine de creuser — les vraies API capteurs et navigateur, celles qui ne se comportent correctement qu'en dehors d'une simulation.
Pourquoi ça fonctionne
- Le serveur de développement écoute déjà sur toutes les interfaces, pas seulement sur l'ordinateur.
docker-entrypoint.shle lance avecyarn start --host 0.0.0.0; sans ce flag, il ne répondrait qu'aux requêtes venant de son propre container, invisible pour tout le reste — y compris l'adaptateur Wi-Fi de l'ordinateur. - Docker publie le port sur le réseau de l'ordinateur. Le
compose.yamldu devcontainer déclareports: - "3000:3000", et Docker Desktop lie un port publié sur chaque interface réseau de l'ordinateur, Wi-Fi compris. C'est ce qui rend le serveur de développement joignable depuis le téléphone. Le port forwarding de VS Code (le panneau Ports) n'intervient pas : il ne redirige que verslocalhostsur l'ordinateur. - HTTPS est volontaire, pas accidentel. Une liste grandissante d'API navigateur — capteurs de mouvement, accès au presse-papiers, service workers, caméra et micro — refusent de fonctionner hors d'un contexte sécurisé. Un serveur de développement qui répondrait en HTTP simple masquerait précisément le comportement qu'aura un vrai site HTTPS déployé.
- Le même Wi-Fi est la seule exigence. Rien ne transite par internet, aucune configuration de routeur, aucun compte — le téléphone et l'ordinateur doivent juste pouvoir se voir sur le sous-réseau local. L'exception courante est traitée juste après.
Quand votre téléphone n'y arrive pas
Certains réseaux refusent : le Wi-Fi invité et pas mal de réseaux publics ou d'entreprise activent l'isolation des clients, qui empêche volontairement les appareils d'un même réseau de se joindre, même connectés au même point d'accès. Si le téléphone part en timeout au lieu d'afficher un avertissement de certificat, c'est la raison la plus probable — et revérifier l'adresse IP dix fois n'y changera rien.
Le contournement le plus simple est de créer un réseau où l'isolation ne s'applique pas : activez le partage de connexion mobile du téléphone et connectez-y l'ordinateur. Le téléphone et l'ordinateur sont alors sur le même petit réseau, contrôlé par le téléphone. Relancez ipconfig, car l'ordinateur reçoit une nouvelle adresse sur ce réseau, puis ouvrez https://<new-ip>:3000 depuis le téléphone comme avant. Gardez un œil sur les données mobiles si l'ordinateur se met à télécharger des mises à jour pendant ce temps.
Sous le capot (passez si vous voulez juste l'utiliser)
Pourquoi l'avertissement de certificat apparaît. Le certificat du serveur de développement n'est pas auto-signé : docker-entrypoint.sh le génère avec mkcert, signé par une autorité de certification locale que l'ordinateur reconnaît déjà. Le téléphone y voit deux problèmes. D'abord, il n'a jamais entendu parler de cette autorité locale, dont le certificat racine n'existe que sur l'ordinateur. Ensuite, le certificat a été émis pour localhost et 127.0.0.1 uniquement, et le téléphone demande votre IP locale (192.168.0.218 dans l'exemple). La connexion reste chiffrée ; ce que le téléphone ne peut pas confirmer, c'est l'identité du serveur, ce qui est acceptable pour un ordinateur dont vous savez déjà qu'il est le vôtre.
Si cliquer sur cet avertissement à chaque session de test vous lasse, l'approche mkcert de Configurez votre localhost Docker pour utiliser SSL sans avertissements du navigateur règle les deux problèmes en deux changements. Ajoutez l'IP locale aux noms couverts par le certificat (mkcert ... localhost 127.0.0.1 <your-lan-ip>), puis installez sur le téléphone le fichier rootCA.pem pointé par mkcert -CAROOT comme autorité de certification de confiance. Ensuite, le téléphone accepte le certificat comme n'importe quel autre, sans avertissement.
Et si le port n'est pas publié ? Un devcontainer démarré depuis une simple image ou un Dockerfile, sans entrée ports: dans un fichier Compose (ni appPort dans devcontainer.json), n'est joignable que par le port forwarding de VS Code, et ce forwarding n'écoute que sur localhost. Le téléphone ne peut alors pas l'atteindre. La solution est de publier le port : ajoutez "3000:3000" à la liste ports: du service, ou "appPort": [3000] dans devcontainer.json, puis reconstruisez le container. Vérifié sur l'installation de ce blog (Windows + WSL2 + Docker Desktop).
Conclusion
Aucun déploiement, aucun plugin, aucune nouvelle dépendance — un serveur de développement déjà configuré pour ça (--host 0.0.0.0, HTTPS, un port publié par Docker) s'avère déjà accessible depuis un vrai téléphone sur le même Wi-Fi, à une adresse IP et un avertissement de certificat près. Cet avertissement coûte un clic, une fois : pas de quoi renoncer à tester sur un vrai appareil — un geste de secousse, une vibration haptique ou une invite d'installation ne se prouvent vraiment que là.
Les deux chemins d'accès
- Même Wi-Fi :
ipconfig(Windows) pour l'adresse IPv4 locale de l'ordinateur, puishttps://<that-ip>:3000depuis le téléphone — acceptez l'avertissement de certificat une fois - Isolation des clients qui bloque le trafic entre appareils : activez le partage de connexion du téléphone, connectez-y l'ordinateur, relancez
ipconfigpour la nouvelle adresse - Avertissement de certificat trop récurrent : ajoutez l'IP locale au certificat
mkcertet installez lerootCA.pemde mkcert sur le téléphone — voir Configurez votre localhost Docker pour utiliser SSL sans avertissements du navigateur






