curl: (7) Failed to connect to localhost port 8080 after 0 ms: Couldn't connect to server
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
docker run -d --name web nginx:1.27-alpine
curl localhost:8080docker rm -f web
docker run -d --name web -p 8080:80 nginx:1.27-alpine
curl localhost:8080Fă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
docker run -d -p 80:8080 nginx:1.27-alpine
curl localhost:8080docker run -d -p 8080:80 nginx:1.27-alpine
curl localhost:8080Ordinea e calculator:container. nginx ascultă pe 80 în container, deci 80 vine în dreapta.
3Aplicația ascultă pe alt port
# aplicația: app.listen(3000)
docker run -d -p 8080:8080 magazin-apidocker run -d -p 8080:3000 magazin-apiPortul din dreapta trebuie să fie cel pe care ascultă chiar aplicația în container.
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.
Reparația
docker ps arată 80/tcp, adică portul nu e publicat. Recreează containerul cu -p:
docker rm -f web
docker run -d --name web -p 8080:80 nginx:1.27-alpine
docker port web
curl -s localhost:808080/tcp -> 0.0.0.0:8080
80/tcp -> [::]:8080Pagina conține Welcome to nginx!.
De ce merge
docker ps arată pentru web doar 80/tcp: portul e expus în container, dar nu e legat de niciun port al calculatorului. Porturile nu se pot adăuga ulterior, așa că ștergi containerul și îl creezi din nou cu -p 8080:80. Acum coloana PORTS arată 0.0.0.0:8080->80/tcp, iar cererile pe localhost:8080 ajung la nginx.
Alte forme ale mesajului
curl: (7) Failed to connect to localhost port 3000 after 0 ms: Connection refusedERR_CONNECTION_REFUSEDcurl: (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
curl: (56) Recv failure: Connection reset by peer Portul e publicat, dar aplicația din container ascultă doar pe 127.0.0.1 (localhost-ul containerului), deci conexiunile venite din afară sunt închise. Pornește serverul pe 0.0.0.0: în Flask app.run(host="0.0.0.0"), în Node app.listen(3000, "0.0.0.0") sau fără adresă. docker: Error response from daemon: driver failed programming external connectivity on endpoint magazin: Bind for 0.0.0.0:8080 failed: port is already allocated. Portul de pe calculator din -p 8080:80 e deja folosit de alt container (sau de alt program). Găsește-l cu docker ps --filter publish=8080, oprește-l, sau publică pe alt port, de exemplu -p 8081:80. Containerul se oprește imediat după pornire: Exited (1) Exited (1) înseamnă că aplicația din container a pornit și a crăpat cu o eroare. Citește motivul cu docker logs nume: de obicei e o cale greșită în CMD, un fișier sau un modul lipsă, o variabilă de mediu obligatorie nesetată sau o eroare în cod. Î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.
