Aller au contenu

Guide

Localhost : 127.0.0.1, ports 8080, 3000 et phpMyAdmin expliqués

Ce qu’est localhost, à quoi correspondent localhost:8080, :3000 ou /phpmyadmin, et comment résoudre « localhost a refusé de se connecter ».

Par La rédaction Publié le

« localhost » désigne votre propre ordinateur. Taper localhost, localhost:8080 ou localhost/phpmyadmin dans un navigateur ouvre un service qui tourne sur votre machine, jamais un site Internet. Si vous arrivez sur cette page après avoir saisi l’adresse dans un moteur de recherche, la bonne méthode est de la taper directement dans la barre d’adresse : http://localhost:8080. Voici comment fonctionne localhost, à quoi correspondent les ports courants et comment résoudre les erreurs de connexion.

Qu’est-ce que localhost ?

localhost est un nom réservé qui pointe toujours vers la machine sur laquelle on se trouve. Il correspond à l’adresse IPv4 127.0.0.1 et à l’adresse IPv6 ::1, dites adresses de bouclage (loopback) : les données envoyées à ces adresses ne quittent jamais l’ordinateur. Toute la plage 127.0.0.0 à 127.255.255.255 est réservée à cet usage.

Les développeurs s’en servent pour tester un site, une application ou une base de données sur leur poste avant de les mettre en ligne sur un serveur.

localhost et les numéros de port

Le nombre après les deux-points indique le port : il désigne le programme qui doit répondre. Sans numéro, le navigateur utilise le port 80 en HTTP et 443 en HTTPS.

Adresse Service habituellement concerné
localhost ou localhost:80 Serveur web local : Apache ou Nginx, XAMPP, WampServer, Laragon.
localhost:8080 Port HTTP alternatif : Apache Tomcat, Jenkins, serveurs de développement, ou Apache quand le port 80 est déjà pris.
localhost:3000 Serveurs de développement JavaScript : Next.js, Create React App, nombreuses applications Node.js et Express.
localhost:8000 Serveur de développement Django (runserver) et serveur intégré de Python (python -m http.server).
localhost:5173 Serveur de développement Vite.
localhost:4200 Serveur de développement Angular.
localhost:5000 Serveur de développement Flask.
localhost:8888 Apache dans MAMP (configuration par défaut).

Ces ports sont des conventions et des valeurs par défaut : chaque outil permet d’en choisir un autre. Le terminal qui a lancé le serveur affiche presque toujours l’adresse exacte à ouvrir.

localhost/phpmyadmin

phpMyAdmin est une interface web pour gérer les bases de données MySQL et MariaDB. Dans les environnements de développement comme XAMPP, WampServer ou Laragon, elle est accessible à l’adresse http://localhost/phpmyadmin, à condition que le serveur web (Apache) et le serveur de base de données (MySQL ou MariaDB) soient démarrés dans le panneau de contrôle. Avec MAMP, l’adresse inclut le port : http://localhost:8888/phpMyAdmin.

localhost/wordpress et localhost/index.php

Quand WordPress est installé en local dans un sous-dossier du serveur web (par exemple htdocs/wordpress dans XAMPP), le site est accessible sur http://localhost/wordpress. L’adresse localhost/index.php appelle le fichier index.php placé à la racine du serveur web local.

« localhost a refusé de se connecter » : que faire ?

  1. Vérifiez que le serveur est démarré : panneau XAMPP ou WampServer, ou terminal où tourne npm run dev, python manage.py runserver, etc.
  2. Vérifiez le port : l’adresse doit correspondre au port affiché au démarrage du serveur.
  3. Cherchez un conflit de port : un autre programme utilise peut-être déjà le port. Sous Windows, netstat -ano | findstr :8080 l’indique ; sous macOS et Linux, lsof -i :8080.
  4. Essayez 127.0.0.1 à la place de localhost : si le serveur n’écoute qu’en IPv4 alors que localhost est résolu en ::1, l’une des deux adresses peut échouer.
  5. Vérifiez le pare-feu et l’antivirus, qui bloquent parfois les serveurs locaux.

Accéder à localhost depuis un autre appareil

localhost désigne toujours l’appareil lui-même : sur votre téléphone, localhost pointe vers le téléphone, pas vers votre ordinateur. Pour tester un site local depuis un autre appareil du même réseau, utilisez l’adresse IP locale de l’ordinateur (par exemple 192.168.1.20:3000) et configurez le serveur pour écouter sur toutes les interfaces (souvent avec l’option --host 0.0.0.0). Pour rendre un site accessible depuis Internet, il faut l’héberger sur un serveur : notre guide serveur dédié ou VPS aide à choisir.

Questions fréquentes

localhost est-il dangereux ?

Non. Une adresse localhost ne mène qu’à votre propre machine. En revanche, un service local qui écoute sur toutes les interfaces peut être accessible depuis le réseau : réservez cela aux réseaux de confiance.

Quelle est la différence entre localhost et 127.0.0.1 ?

localhost est un nom, 127.0.0.1 une adresse. Le système traduit le nom en adresse, en IPv4 (127.0.0.1) ou en IPv6 (::1) selon la configuration.

Quelle est mon adresse IP publique ?

Ce n’est pas 127.0.0.1 : votre adresse publique est celle de votre box ou de votre opérateur. Notre outil mon adresse IP publique l’affiche.

Sources

À lire aussi