...
Eroare Docker · Containere care se opresc imediat

nginx: [emerg] host not found in upstream "api" in /etc/nginx/conf.d/default.conf:4

Pe scurt

La pornire, nginx nu poate rezolva numele din proxy_pass (aici api), așa că se oprește. Pune containerul nginx în aceeași rețea Docker cu containerul api (aceeași rețea proprie sau același proiect Compose) și verifică numele serviciului.

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

Ce înseamnă

Într-un reverse proxy, proxy_pass http://api:3000; îi spune lui nginx să trimită cererile către api. Nginx rezolvă numele la pornire; dacă DNS-ul nu știe numele, afișează [emerg] host not found in upstream "api" cu fișierul și linia, apoi se oprește, iar containerul ajunge Exited (1).

În Docker, numele containerelor se rezolvă doar în rețelele proprii (docker network create) și în rețeaua proiectului Compose. De aceea apare când:

  • containerul nginx e pe rețeaua implicită bridge, unde nu există DNS între containere;
  • nginx și api sunt în rețele diferite;
  • numele din proxy_pass nu e numele serviciului (backend față de api);
  • containerul api nu există încă sau a fost șters.

Verifică cu docker network inspect retea ce containere sunt în fiecare rețea.

De ce apare: cauzele frecvente

1nginx pe rețeaua implicită

Greșit
BASH
docker run -d --name proxy -p 8080:80 -v ~/proxy/default.conf:/etc/nginx/conf.d/default.conf:ro nginx:1.27-alpine
Corect
BASH
docker run -d --name proxy --network magazin-net -p 8080:80 -v ~/proxy/default.conf:/etc/nginx/conf.d/default.conf:ro nginx:1.27-alpine

În magazin-net, DNS-ul Docker rezolvă api la containerul API.

2Nume diferit de serviciu

Greșit
BASH
location / {
    proxy_pass http://backend:3000;
}
Corect
BASH
location / {
    proxy_pass http://api:3000;
}

Numele din proxy_pass trebuie să fie exact numele serviciului sau al containerului.

3Servicii în rețele Compose diferite

Greșit
BASH
services:
  proxy:
    networks: [front]
  api:
    networks: [back]
Corect
BASH
services:
  proxy:
    networks: [front, back]
  api:
    networks: [back]

Proxy-ul trebuie să fie și în rețeaua în care se află API-ul.

Repară tu

Repară eroarea, direct în pagină

API-ul rulează în containerul api, în rețeaua magazin-net. Proxy-ul proxy (nginx, cu proxy_pass http://api:3000; în ~/proxy/default.conf) a fost pornit pe rețeaua implicită și cade cu host not found in upstream "api". Recreează proxy cu aceeași configurație montată, pe portul 8080, astfel încât să fie în aceeași rețea cu api.

Indiciu

docker rm -f proxy, apoi același docker run cu --network magazin-net.

Alte forme ale mesajului

  • nginx: [emerg] host not found in upstream "backend:3000" in /etc/nginx/conf.d/default.conf:5
  • [emerg] 1#1: host not found in upstream "api" in /etc/nginx/conf.d/default.conf:4

Cum o eviți pe viitor

Pune proxy-ul și serviciile din spatele lui în același proiect Compose sau în aceeași rețea proprie și folosește numele serviciilor în proxy_pass. Testează configurația înainte de pornire cu docker run --rm --network retea -v ...:ro nginx nginx -t. Dacă API-ul poate porni după nginx, folosește în Compose depends_on sau un resolver 127.0.0.11 cu variabilă în proxy_pass, ca nginx să rezolve numele la fiecare cerere.

Întrebări frecvente

De ce containerul nginx se oprește imediat?

Mesajele [emerg] sunt fatale: nginx refuză să pornească cu o configurație pe care nu o poate aplica. docker logs proxy îți arată linia exactă.

Merge cu localhost:3000 în loc de api:3000?

Nu. În containerul nginx, localhost e chiar containerul nginx. Pentru API ai nevoie de numele lui în rețeaua Docker.

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.