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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare container are propria interfață de rețea și propriul localhost. Când publici -p 5000:5000, Docker trimite traficul de pe calculator către IP-ul containerului, nu către 127.0.0.1 din container. Dacă aplicația ascultă doar pe 127.0.0.1, conexiunea ajunge la container, dar nu găsește pe nimeni la adresa aceea, iar curl primește Connection reset by peer (sau Empty reply from server).
Cel mai des se întâmplă cu serverele de dezvoltare, care ascultă implicit pe localhost din motive de siguranță: Flask (app.run()), flask run, Django runserver, Vite, Angular ng serve. În container, aceste servere par să funcționeze (docker logs arată Running on http://127.0.0.1:5000), iar docker exec … curl localhost:5000 din interior chiar merge, ceea ce face eroarea derutantă.
Indiciul din jurnal e chiar adresa: 127.0.0.1 înseamnă doar din interior, 0.0.0.0 înseamnă de pe toate interfețele.
De ce apare: cauzele frecvente
1Flask pornit fără host
app.run(port=5000)app.run(host="0.0.0.0", port=5000)Implicit Flask ascultă pe 127.0.0.1. Cu 0.0.0.0 acceptă conexiuni pe interfața containerului, unde ajunge traficul publicat.
2Server de dezvoltare pornit din CMD
CMD ["flask", "run"]
# sau
CMD ["npm", "run", "dev"] # ViteCMD ["flask", "run", "--host=0.0.0.0"]
# sau
CMD ["npm", "run", "dev", "--", "--host", "0.0.0.0"]Uneltele de dezvoltare au opțiuni pentru adresa de ascultare; în container trebuie să fie 0.0.0.0.
3Node legat explicit de localhost
app.listen(3000, "127.0.0.1")app.listen(3000) // sau app.listen(3000, "0.0.0.0")Fără adresă, Node ascultă pe toate interfețele, inclusiv cea a containerului.
Repară eroarea, direct în pagină
În ~/salut-api ai un API Flask construit ca salut-api:1.0 și pornit cu -p 5000:5000, dar curl localhost:5000 dă curl: (56) Recv failure: Connection reset by peer. Repară app.py ca serverul să accepte conexiuni din afara containerului, reconstruiește imaginea, recreează containerul salut și verifică răspunsul.
Indiciu
Flask ascultă implicit doar pe 127.0.0.1; în container are nevoie de host="0.0.0.0".
Reparația
Jurnalul arată adresa pe care ascultă serverul:
docker logs salut * Running on http://127.0.0.1:5000Fă serverul să asculte pe toate interfețele, reconstruiește și recreează containerul:
sed -i 's/app.run(port=5000)/app.run(host="0.0.0.0", port=5000)/' app.py
docker build -t salut-api:1.0 .
docker rm -f salut
docker run -d --name salut -p 5000:5000 salut-api:1.0
curl -s localhost:5000Salut de la API-ul biblioteciiDe ce merge
Traficul publicat cu -p 5000:5000 intră în container pe interfața lui de rețea, nu pe 127.0.0.1. Cu app.run(port=5000), Flask asculta doar pe localhost-ul containerului, așa că nu primea conexiunile venite de pe calculator. Cu host="0.0.0.0" ascultă pe toate interfețele, iar după rebuild și recrearea containerului, curl localhost:5000 primește răspunsul.
Alte forme ale mesajului
curl: (52) Empty reply from serverERR_CONNECTION_RESETThis page isn't working: localhost didn't send any data. ERR_EMPTY_RESPONSE
Cum o eviți pe viitor
În aplicațiile pe care le pui în containere, citește adresa și portul din variabile de mediu, cu 0.0.0.0 implicit (HOST=0.0.0.0, PORT=5000). Pentru producție, folosește un server real în loc de serverul de dezvoltare: gunicorn -b 0.0.0.0:5000 app:app pentru Flask. După pornire, verifică în docker logs adresa afișată de server și testează de pe calculator cu curl localhost:PORT.
Întrebări frecvente
Din interiorul containerului merge. De ce?
Pentru că în interior, localhost e chiar containerul, iar aplicația ascultă acolo. Traficul publicat cu -p vine însă pe interfața de rețea a containerului (de exemplu 172.17.0.2), nu pe 127.0.0.1.
E periculos să ascult pe 0.0.0.0?
În container, nu: containerul e izolat, iar accesul din afară îl controlezi tu prin -p. Dacă vrei ca portul să fie accesibil doar de pe calculatorul tău, publică-l cu -p 127.0.0.1:5000:5000.
Erori înrudite
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. 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.
