October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk8 min

Comment résoudre l’erreur Localhost n’autorise pas la connexion

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

L’erreur Localhost n’autorise pas la connexion apparaît quand votre navigateur (ou un client) essaie de contacter un service local sur localhost, mais que la connexion est refusée, échoue, ou n’est pas routée comme prévu. Le message exact varie selon le navigateur, mais le diagnostic reste très souvent le même: le serveur n’est pas joignable sur l’hôte/port attendu.

Ce guide vous fait passer par une méthode fiable: identifier le bon port, vérifier l’écoute réseau, tester avec des commandes simples, puis corriger la cause (serveur arrêté, port en conflit, mauvais binding 127.0.0.1/0.0.0.0, IPv6, pare-feu, protocole HTTP/HTTPS, reverse proxy).

As an Amazon Associate I earn from qualifying purchases.

Comprendre l’erreur Localhost n’autorise pas la connexion

Le terme localhost correspond à l’ordinateur local via 127.0.0.1 (IPv4) et parfois ::1 (IPv6). Selon votre stack, l’erreur peut refléter plusieurs états:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Connexion refusée (souvent: rien n’écoute sur le port, ou service crash)
  • Délai dépassé (souvent: pare-feu, mauvais routage, proxy, reverse proxy cassé)
  • Protocole/URL incorrect (ex: tenter https:// sur un serveur http://)

La clé: ne changez pas tout. Commencez par vérifier si quelque chose écoute réellement sur le port que vous essayez d’ouvrir.

#1 Best Overall
Sale
Pearson Computer Networking, 8E
  • brand: Pearson
  • Computer Networking, 8e

Pré-requis et collecte des infos

Avant toute réparation, notez 4 éléments. Cela évite de tourner en rond.

  • URL exacte dans le navigateur: par ex. http://localhost:3000
  • Port (ex: 3000, 8080, 8000, 443)
  • Protocole (HTTP vs HTTPS)
  • OS (Windows, macOS, Linux) et le navigateur (Chrome, Safari, Firefox, Edge)

Vérifier d’abord le plus probable (serveur et port)

La cause la plus fréquente reste simple: le serveur n’est pas démarré, ou il écoute sur un autre port.

  1. Relancez votre projet (exécution du framework ou du backend).
  2. Vérifiez le port annoncé au démarrage (ex: Vite dit souvent Local: http://localhost:5173).
  3. Essayez d’ouvrir l’URL exacte annoncée par la console.

Si vous ne voyez aucun port dans la console, ou si le processus se ferme immédiatement, passez à la section Serveur non démarré ou crash.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Tests réseau rapides (sans changer la configuration)

Ces tests confirment en 30 secondes si le problème est “réseau/port” ou “app”.

Test direct avec curl

Sur votre machine, exécutez:

  • curl -v http://127.0.0.1:3000
  • curl -v http://localhost:3000

Résultats typiques:

  • Connection refused: rien n’écoute sur ce port
  • Connection timed out: pare-feu/proxy ou service bloqué
  • HTTP/1.1 200 (ou 301/302/404): le port fonctionne, l’URL ou l’app peut être en cause

Vérifier l’écoute du port (netstat/ss/lsof)

Vous cherchez une ligne indiquant que votre service écoute sur 127.0.0.1, 0.0.0.0 ou ::1 et sur le bon port.

Résolution par cause fréquente

Serveur non démarré ou crash au démarrage

Si aucun service n’écoute, curl retournera “connection refused”.

  1. Relancez le serveur depuis le terminal (et observez les erreurs).
  2. Regardez la sortie juste après le lancement: port, compilation, crash stack trace.
  3. Si vous utilisez Docker, vérifiez aussi que le conteneur est “running”.

Astuce: si le terminal affiche un autre port (ex: 5173 au lieu de 3000), vous ouvrez probablement la mauvaise URL.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Port incorrect ou en conflit

Un autre processus peut occuper le port. Les frameworks proposent parfois un port de secours, ce qui vous surprend.

  1. Identifiez le port que le serveur a réellement choisi.
  2. Libérez le port (arrêtez le processus occupant le port) ou changez le port de votre app.
  3. Relancez et testez de nouveau avec curl.

Binding sur 127.0.0.1 seulement vs 0.0.0.0

La plupart des serveurs démarrent en local sur 127.0.0.1. C’est parfait pour localhost, mais ça peut casser si vous testez via un autre nom/hôte ou un conteneur.

Si vous utilisez Docker ou un reverse proxy, assurez-vous que votre serveur écoute au bon niveau. Typiquement:

  • Écoute locale uniquement: 127.0.0.1
  • Écoute sur l’interface réseau: 0.0.0.0

Selon votre framework, le réglage se fait via une option d’hôte (ex: host / --host / server.host).

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

IPv6 vs IPv4 (::1 vs 127.0.0.1)

Certains systèmes résolvent localhost vers ::1 (IPv6) plutôt que 127.0.0.1. Si votre serveur n’écoute que sur IPv4, le navigateur peut échouer.

  1. Testez explicitement http://127.0.0.1:<port>.
  2. Si ça marche, votre serveur n’écoute pas IPv6.
  3. Faites en sorte que votre serveur écoute sur :: (selon les options) ou forcez l’URL côté client.

Pare-feu, VPN, proxy, antivirus

Un pare-feu peut bloquer les connexions “locales” selon la configuration, surtout avec des outils de sécurité ou des proxies.

  • Désactivez temporairement le VPN et le proxy du navigateur (paramètres réseau du navigateur).
  • Sur Windows, vérifiez Windows Defender Firewall pour l’application/le port.
  • Si vous utilisez un environnement d’entreprise, testez avec un réseau différent.

Si curl -v http://127.0.0.1:<port> marche mais le navigateur non, c’est souvent un proxy navigateur ou une configuration DNS/Proxy particulière.

Service en écoute sur un autre protocole (HTTP/HTTPS)

Une erreur classique: tenter https://localhost:3000 alors que le serveur sert du HTTP simple.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Essayez http://localhost:<port> (pas https).
  2. Si vous devez utiliser HTTPS, vérifiez la config TLS (certificats, chemins, variables d’environnement).

Symptôme typique: navigateur renvoie un message de type “ERR_SSL_PROTOCOL_ERROR” ou “site inaccessible”.

Reverse proxy (Nginx/Traefik) ou configuration TLS

Si votre URL passe par Nginx/Traefik, l’erreur peut venir du proxy plutôt que du serveur applicatif.

  • Vérifiez le backend défini (ex: proxy_pass http://127.0.0.1:3000).
  • Contrôlez les règles de routage (server_name, path prefix).
  • Regardez les logs du reverse proxy: ils donnent souvent l’IP/port cible et la raison du refus.

Procédures par système d’exploitation

Utilisez ces commandes pour confirmer l’état d’écoute du port. Remplacez <PORT> par votre port (ex: 3000).

Windows

Sur Windows, ouvrez un terminal (PowerShell ou Invite de commandes en admin si besoin).

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Lister les connexions et ports en écoute: netstat -ano | findstr :<PORT>
  2. Identifier le PID: prenez le dernier nombre (PID) de la ligne trouvée.
  3. Trouver le processus: tasklist /fi "PID eq <PID>"
  4. Test client: curl -v http://127.0.0.1:<PORT>

Si aucune ligne n’apparaît, rien n’écoute sur ce port (ou vous cherchez le mauvais port).

macOS

Sur macOS, privilégiez lsof et curl.

  1. Voir ce qui écoute sur un port: sudo lsof -nP -iTCP:<PORT> -sTCP:LISTEN
  2. Test rapide: curl -v http://127.0.0.1:<PORT>
  3. Si ça n’affiche rien: port incorrect, service arrêté, ou binding différent (IPv6/IPv4).

Linux

Sur Linux, ss est souvent plus rapide que netstat.

  1. Afficher les sockets en écoute: sudo ss -ltnp '( sport = :<PORT> )'
  2. Si vous avez besoin du nom du service: utilisez le PID pour récupérer le processus.
  3. Test: curl -v http://127.0.0.1:<PORT>

Si le port écoute uniquement sur IPv6, testez aussi http://[::1]:<PORT> selon votre contexte.

Cas développeur: frameworks et environnements locaux

Les erreurs “localhost refuse” sont souvent la combinaison d’un port attendu et d’un hôte d’écoute différent. Voici les réglages typiques par écosystème.

Node.js / npm / JavaScript (Express, Next.js, Vite)

Pour Express, vérifiez le listen. Exemple typique:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • app.listen(PORT, '127.0.0.1') (IPv4 seulement)
  • app.listen(PORT, '0.0.0.0') (écoute sur toutes interfaces)

Pour Vite (avec npm), la console affiche souvent l’URL exacte (ex: http://localhost:5173). Si vous utilisez Docker, ajoutez un host adapté (option --host ou config server.host).

Pour Next.js, contrôlez next dev -H (ou configuration équivalente) si vous êtes en reverse proxy / conteneur.

Python (Flask, FastAPI, Django)

Flask et FastAPI ont un paramètre d’hôte. Sur Flask, par exemple: app.run(host='127.0.0.1', port=5000).

  • Si vous passez par Docker, préférez souvent 0.0.0.0.
  • Confirmez ensuite le port publié dans le conteneur.

Django: vérifiez runserver 0.0.0.0:8000 quand vous testez depuis l’extérieur du conteneur.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

WordPress en local (MAMP, LocalWP, Docker)

Sur WordPress, l’erreur peut venir d’Apache/Nginx local (port 80/8888/8080), ou de la config du conteneur.

  1. Vérifiez dans MAMP/LocalWP quel port HTTP est actif (ex: 80 ou 8888).
  2. Testez http://127.0.0.1:<port>/.
  3. Si vous utilisez Docker: confirmez le mapping ports (ex: 8000:80).

Si votre navigateur échoue mais que le test curl marche, regardez CORS et configuration de l’URL dans le navigateur/app.

Quand ce n’est pas du réseau: erreurs liées à CORS, auth, ou routes

Parfois le message “connexion” masque un autre problème. Si curl obtient bien une réponse HTTP (même 401/403/404), la connexion au serveur est ok. Ensuite, la cause est souvent:

  • Auth: vous êtes redirigé, mais l’app attend un token/cookie
  • Routes: endpoint inexistant (404)
  • CORS: l’appel navigateur échoue après chargement, pas avant connexion

Pour CORS, cherchez plutôt des erreurs “CORS policy” dans la console du navigateur que des “refused”.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Comparaison des messages et que faire selon le symptôme

Symptôme (souvent) Cause probable Première action
Connection refused Rien n’écoute sur le port, ou serveur crash curl -v http://127.0.0.1:<PORT> + vérifier console du serveur
Timed out Pare-feu/proxy/VPN, route bloquée, reverse proxy cassé Tester avec curl et vérifier Nginx/Traefik + logs
Erreur SSL/TLS HTTPS sur un serveur HTTP, certificat manquant/incorrect Basculer en http:// ou corriger TLS côté serveur
Marche en 127.0.0.1 mais pas en localhost IPv6/IPv4 désalignés Forcer 127.0.0.1 ou activer écoute IPv6

Erreurs fréquentes et checklist de correction

Si vous voulez une méthode “imprimable”, suivez cette checklist.

  • Port: l’URL du navigateur correspond-elle exactement au port annoncé par le serveur?
  • Écoute: ss/lsof/netstat montre-t-il une écoute sur ce port?
  • Hôte: le serveur écoute-t-il sur 127.0.0.1 (ou 0.0.0.0 si conteneur/reverse proxy)?
  • Protocole: essayez http:// vs https://.
  • IPv6: testez http://127.0.0.1 pour isoler le problème.
  • Pare-feu/proxy: désactivez temporairement proxy/VPN, et testez.
  • Reverse proxy: vérifiez proxy_pass, règles de routage, et logs du proxy.

Quand vous trouvez la différence entre deux tests (ex: curl marche mais le navigateur non), vous savez où concentrer la correction.

FAQ

Pourquoi mon navigateur affiche Localhost n’autorise pas la connexion alors que mon serveur semble démarré?

Le serveur peut être “démarré” mais écouter sur un autre port, un autre hôte (IPv6 seulement), ou être bloqué par un reverse proxy. Confirmez avec ss/lsof/netstat et curl -v.

Je vois une écoute sur le port, mais ça échoue quand même: que vérifier?

Vérifiez le protocole (HTTP vs HTTPS), l’URL exacte (chemin), et la config du proxy (Nginx/Traefik). Si curl renvoie une réponse HTTP, le réseau fonctionne et l’erreur vient de l’app.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Dois-je utiliser localhost ou 127.0.0.1?

Pour diagnostiquer un problème IPv6/IPv4, utilisez 127.0.0.1. Une fois stable, vous pouvez revenir à localhost si tout fonctionne proprement.

Windows: comment savoir quel programme bloque un port?

Utilisez netstat -ano | findstr :<PORT> puis tasklist /fi "PID eq <PID>". Ensuite, arrêtez l’application fautive ou changez votre port.

Bottom Line

L’erreur Localhost n’autorise pas la connexion se résout presque toujours en confirmant: le bon port, une écoute effective, et un host/protocole cohérents. Commencez par curl -v et la commande d’inspection du port (netstat, lsof, ss), puis corrigez la configuration (binding, IPv6, pare-feu, reverse proxy).

Si vous me donnez votre URL exacte, le port, et ce que renvoie curl -v, je peux vous aider à isoler la cause en quelques itérations.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.