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

curl: (7) Failed to connect to localhost port 8080 after 0 ms: Couldn't connect to server

Pe scurt

Pe calculator nu ascultă nimic pe portul 8080: containerul nu publică portul (lipsește -p 8080:80), e oprit sau portul din dreapta nu e cel pe care ascultă aplicația. Verifică cu docker ps coloana PORTS și recreează containerul cu -p 8080:80.

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

Ce înseamnă

Eroarea 7 a lui curl înseamnă că nici măcar n-a putut deschide conexiunea: niciun proces nu ascultă pe localhost:8080. Spre deosebire de Connection reset by peer, aici traficul nu ajunge deloc la container.

În Docker, cauza tipică este că portul nu e publicat. EXPOSE 80 din Dockerfile doar documentează portul și nu deschide nimic pe calculator; publicarea se face la pornire, cu -p 8080:80 (calculator:container) sau ports: în compose.yaml. În docker ps, coloana PORTS îți arată diferența: 80/tcp înseamnă doar expus, 0.0.0.0:8080->80/tcp înseamnă publicat.

Alte cauze: containerul s-a oprit (docker ps -a), ai inversat porturile (-p 80:8080 când aplicația ascultă pe 80), aplicația ascultă pe alt port decât cel din dreapta sau încerci portul containerului (80) în loc de cel al calculatorului (8080).

De ce apare: cauzele frecvente

1Portul nu e publicat

Greșit
BASH
docker run -d --name web nginx:1.27-alpine
curl localhost:8080
Corect
BASH
docker rm -f web
docker run -d --name web -p 8080:80 nginx:1.27-alpine
curl localhost:8080

Fără -p, portul 80 al containerului e accesibil doar din rețeaua Docker. -p 8080:80 îl leagă de portul 8080 al calculatorului.

2Porturile sunt inversate

Greșit
BASH
docker run -d -p 80:8080 nginx:1.27-alpine
curl localhost:8080
Corect
BASH
docker run -d -p 8080:80 nginx:1.27-alpine
curl localhost:8080

Ordinea e calculator:container. nginx ascultă pe 80 în container, deci 80 vine în dreapta.

3Aplicația ascultă pe alt port

Greșit
BASH
# aplicația: app.listen(3000)
docker run -d -p 8080:8080 magazin-api
Corect
BASH
docker run -d -p 8080:3000 magazin-api

Portul din dreapta trebuie să fie cel pe care ascultă chiar aplicația în container.

Repară tu

Repară eroarea, direct în pagină

Ai pornit site-ul cu docker run -d --name web nginx:1.27-alpine, dar curl localhost:8080 dă curl: (7) Failed to connect to localhost port 8080. Uită-te la coloana PORTS din docker ps, apoi recreează containerul web astfel încât pagina să răspundă pe portul 8080 al calculatorului.

Indiciu

Ordinea la -p este port_calculator:port_container, iar nginx ascultă în container pe 80.

Alte forme ale mesajului

  • curl: (7) Failed to connect to localhost port 3000 after 0 ms: Connection refused
  • ERR_CONNECTION_REFUSED
  • curl: (7) Failed to connect to 127.0.0.1 port 5432: Connection refused

Cum o eviți pe viitor

Când pornești un serviciu, scrie -p imediat după --name, ca să nu-l uiți, și verifică coloana PORTS din docker ps. Ține în Dockerfile EXPOSE cu portul real al aplicației, ca documentație pentru cine scrie -p. În compose.yaml, scrie porturile mereu între ghilimele ("8080:80"). docker port nume îți arată rapid ce porturi sunt publicate și unde.

Întrebări frecvente

EXPOSE nu publică portul?

Nu. EXPOSE e metadată: spune ce port folosește aplicația. Portul ajunge pe calculator doar cu -p (sau -P, care publică toate porturile expuse pe porturi alese de Docker).

Pot adăuga un port unui container care rulează?

Nu. Porturile se stabilesc la crearea containerului; trebuie să-l ștergi și să-l pornești din nou cu -p. Datele importante trebuie să fie în volume ca să poți face asta fără griji.

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.