Quand on travaille en tant que Data Engineering, on lance souvent des services en local :
- un serveur PostgreSQL dans Docker
- un dbt docs serve
- un airflow webserver
- une API Flask, FastAPI ou un dashboard Superset
Et souvent, tout tourne “sur localhost”.
Mais... est-ce vraiment la même chose que 127.0.0.1 ?
Spoiler : presque, mais pas tout à fait.
Et connaître cette différence peut t’éviter pas mal de galères réseaux ou Docker.
Qu’est-ce que localhost ?
localhost, c’est un nom de domaine spécifique qui désigne ta propre machine.
Quand tu tapes :
ton navigateur ou ton script Python ne va pas sur Internet. Il demande simplement au système d’exploitation :
“C’est quoi l’adresse IP de localhost ?”
Et là, ton OS regarde dans le fichier hosts (défini localement) :
- macOS / Linux → /etc/hosts
- Windows → C:\Windows\System32\drivers\etc\hosts
Et il trouve souvent :
127.0.0.1 localhost
::1 localhost
Ce fichier remplace le DNS pour tout ce qui est local.
Autrement dit, localhost → ton IP locale.
Et 127.0.0.1, c’est quoi ?
127.0.0.1 est une adresse IP réservée à la boucle locale (loopback address).
Quand tu pingues cette adresse, tu ne sors pas du tout sur le réseau internet.
C’est ton système d’exploitation qui intercepte la requête et la renvoie directement vers lui-même.
C’est utile pour :
- tester un service web sans connexion Internet
- vérifier si ton serveur écoute bien
- faire du debug réseau sans impacter d’autres machines
Donc, c’est la même chose ?
Pas toujours....
C’est surtout la résolution qui fait la différence.
Si ton /etc/hosts est modifié, localhost pourrait pointer vers autre chose (par exemple une IP LAN).
Mais 127.0.0.1 restera toujours ta machine.
🐳 Exemple : Docker & localhost
C’est souvent ici que les Data Engineers se prennent la tête.
Quand tu lances un conteneur Docker :
docker run -p 8080:8080 my-api
et que ton code Python à l’extérieur essaie de se connecter à localhost:8080, tout marche.
Mais à l’intérieur du conteneur, localhost ne désigne pas ton ordinateur,
il désigne le conteneur lui-même.
Si tu veux que le conteneur parle à ton service local, il faut utiliser :
- host.docker.internal (sur Mac/Windows)
- ou directement ton IP locale (127.0.0.1 ne marchera pas depuis Docker Linux).
C’est une confusion très courante dans les setups Airflow, dbt ou Spark + API locales.
L'important à retenir
La meilleure manière d’éviter les confusions entre localhost, 127.0.0.1 et les IP locales :
c’est de faire tourner tous tes services dans Docker et de laisser Docker gérer le réseau.
Cela permet aussi d'avoir un environnement reproductible sur les services Cloud comme Aws, Gcp, Azure.
Sinon ...
localhost et 127.0.0.1 mènent au même endroit... sauf quand ce n’est plus le cas (modification du host)
- Utilise localhost quand tu travailles sur ta machine directement.
- Utilise 127.0.0.1 pour des scripts réseaux précis, ou quand tu veux être sûr d’éviter la résolution DNS.
- Et dans Docker, souviens-toi que “local” dépend du contexte réseau du conteneur.
