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

curl: (56) Recv failure: Connection reset by peer

Pe scurt

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

Greșit
BASH
app.run(port=5000)
Corect
BASH
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

Greșit
BASH
CMD ["flask", "run"]
# sau
CMD ["npm", "run", "dev"]   # Vite
Corect
BASH
CMD ["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

Greșit
BASH
app.listen(3000, "127.0.0.1")
Corect
BASH
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ă tu

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".

Alte forme ale mesajului

  • curl: (52) Empty reply from server
  • ERR_CONNECTION_RESET
  • This 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

← 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.