...
Eroare Docker · Rețele, porturi și volume

ping: bad address 'cache'

Pe scurt

Containerul nu poate traduce numele altui container în adresă IP, pentru că sunt pe rețeaua bridge implicită, unde Docker nu oferă DNS după nume. Creează o rețea proprie (docker network create magazin) și leagă ambele containere de ea; acolo numele containerelor se rezolvă automat.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

bad address 'cache' e mesajul BusyBox (Alpine) pentru „nu găsesc o adresă IP pentru numele cache”. Alte unelte spun același lucru altfel: curl: (6) Could not resolve host: cache, getaddrinfo ENOTFOUND cache (Node), could not translate host name "db" to address (Postgres), Name or service not known.

Docker are un server DNS intern (127.0.0.11) care traduce numele containerelor în IP-uri, dar doar pe rețelele create de utilizator (cu docker network create sau de Compose). Containerele pornite fără --network ajung pe rețeaua implicită bridge, unde fiecare are un IP, dar numele nu sunt publicate.

Alte cauze: containerele sunt pe rețele diferite, numele e greșit (în Compose folosești numele serviciului, de exemplu db, nu magazin-db-1) sau containerul țintă e oprit.

De ce apare: cauzele frecvente

1Containerele sunt pe rețeaua bridge implicită

Greșit
BASH
docker run -d --name cache redis:7
docker run -d --name web nginx:1.27-alpine
docker exec web ping -c 1 cache
Corect
BASH
docker network create magazin
docker run -d --name cache --network magazin redis:7
docker run -d --name web --network magazin nginx:1.27-alpine
docker exec web ping -c 1 cache

Pe o rețea proprie, DNS-ul intern Docker traduce numele cache în IP-ul containerului.

2Containerele sunt pe rețele diferite

Greșit
BASH
docker run -d --name api --network front magazin-api
docker run -d --name db --network back postgres:16
Corect
BASH
docker network connect back api

Un container vede doar numele de pe rețelele la care e conectat. network connect îl leagă și de a doua rețea.

3Numele containerului în loc de numele serviciului (Compose)

Greșit
BASH
DATABASE_URL: postgres://app:parola@magazin_db:5432/app
Corect
BASH
DATABASE_URL: postgres://app:parola@db:5432/app

În rețeaua proiectului, fiecare serviciu e accesibil după numele lui din compose.yaml.

Repară tu

Repară eroarea, direct în pagină

Containerele web (nginx:1.27-alpine) și cache (redis:7) rulează pe rețeaua implicită, iar docker exec web ping -c 1 cache dă ping: bad address 'cache'. Creează rețeaua magazin, conectează la ea ambele containere (fără să le recreezi) și verifică cu ping că web găsește acum cache după nume.

Indiciu

Un container existent se leagă de o rețea cu docker network connect rețea container.

Alte forme ale mesajului

  • wget: bad address 'api'
  • curl: (6) Could not resolve host: db
  • Error: getaddrinfo ENOTFOUND db
  • could not translate host name "db" to address: Name or service not known

Cum o eviți pe viitor

Nu folosi rețeaua implicită pentru aplicații cu mai multe containere: creează o rețea proprie sau, și mai simplu, descrie totul în compose.yaml, unde serviciile se găsesc după nume din prima. În configurări, folosește numele serviciilor (db, cache), nu IP-uri: IP-urile se schimbă la fiecare recreare. Testează rezolvarea din containerul care face conexiunea, cu nslookup nume sau ping -c 1 nume.

Întrebări frecvente

Funcționează cu IP-ul, dar nu cu numele. De ce?

Pentru că pe rețeaua bridge implicită conexiunea prin IP merge, dar nu există DNS după nume. IP-ul se poate schimba la repornire, deci soluția corectă e o rețea proprie, nu IP-ul scris în configurare.

Ce este --link și trebuie să-l folosesc?

--link e mecanismul vechi care adăuga numele în /etc/hosts pe rețeaua implicită. E depreciat; rețelele proprii îl înlocuiesc complet.

Erori înrudite

← Toate erorile Docker

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Docker de la zero, cu exerciții la fiecare lecție

Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.