nginx: [emerg] host not found in upstream "api" in /etc/nginx/conf.d/default.conf:4
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_passnu e numele serviciului (backendfață deapi); - 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ă
docker run -d --name proxy -p 8080:80 -v ~/proxy/default.conf:/etc/nginx/conf.d/default.conf:ro nginx:1.27-alpinedocker 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
location / {
proxy_pass http://backend:3000;
}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
services:
proxy:
networks: [front]
api:
networks: [back]services:
proxy:
networks: [front, back]
api:
networks: [back]Proxy-ul trebuie să fie și în rețeaua în care se află API-ul.
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.
Reparația
docker rm -f proxy
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
docker network inspect -f '{{range .Containers}}{{.Name}} {{end}}' magazin-netapi proxyDe ce merge
Pe rețeaua implicită bridge, containerele nu se găsesc după nume, deci nginx nu putea rezolva api la pornire. În magazin-net, DNS-ul intern al Docker rezolvă api la IP-ul containerului API, așa că nginx acceptă proxy_pass, pornește și trimite cererile mai departe. Configurația rămâne montată doar pentru citire, ca înainte.
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
ping: bad address 'cache' Containerul nu poate traduce numele altui container în adresă IP, pentru că sunt pe rețeaua bridge implicită, unde Docker nu oferă DNS după nume. Creează o rețea proprie (docker network create magazin) și leagă ambele containere de ea; acolo numele containerelor se rezolvă automat. nginx: [emerg] unexpected end of file, expecting ";" or "}" in /etc/nginx/conf.d/default.conf:8 Configurația nginx montată în container are o acoladă } lipsă (sau un ; lipsă la final), iar nginx refuză s-o încarce: containerul se oprește la pornire, iar reload-ul eșuează. Repară fișierul, verifică cu docker exec web nginx -t și abia apoi fă nginx -s reload. docker: Error response from daemon: network magazin-net not found. Rețeaua dată la --network nu există pe acest daemon: n-a fost creată încă, are alt nume sau a fost ștearsă. Creeaz-o cu docker network create magazin-net (sau verifică numele cu docker network ls), apoi pornește containerul. Î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.
