connect() failed (111: Connection refused) while connecting to upstream
nginx a primit cererea, dar aplicația spre care o trimite (proxy_pass) nu răspunde pe adresa și portul din configurare, așa că afișează 502 Bad Gateway. Verifică cu ss -tlnp pe ce port ascultă aplicația, pornește-o sau corectează portul din proxy_pass, apoi reload.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când nginx e reverse proxy, vizitatorul primește 502 Bad Gateway, iar în /var/log/nginx/error.log apare cauza exactă: connect() failed (111: Connection refused) while connecting to upstream, upstream: "http://127.0.0.1:3000/". „Upstream” e aplicația ta (Node, Python, PHP-FPM). Eroarea 111 înseamnă că la acea adresă și port nu ascultă nimic.
Cauzele: aplicația nu rulează (s-a oprit, n-a pornit după restart), ascultă pe alt port decât cel din proxy_pass, ascultă doar pe altă adresă (de exemplu doar pe IPv6 sau pe o adresă de rețea, nu pe 127.0.0.1), ori pornește greu și nu e încă gata. Alte variante ale lui 502: upstream prematurely closed connection (aplicația a picat în timpul cererii) și connect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory). Timeout-ul dă de obicei 504 Gateway Time-out.
De ce apare: cauzele frecvente
1Port greșit în proxy_pass
location / { proxy_pass http://127.0.0.1:3000; }
# aplicația ascultă pe 8000location / { proxy_pass http://127.0.0.1:8000; }Portul din proxy_pass trebuie să fie exact cel pe care ascultă aplicația (ss -tlnp).
2Aplicația nu rulează
sudo systemctl status api
# Active: failedsudo systemctl restart api
ss -tlnp | grep 8000Fără proces care ascultă, conexiunea e refuzată. Repară întâi aplicația (jurnalul ei), apoi nginx.
3Socket PHP-FPM cu altă versiune
fastcgi_pass unix:/run/php/php8.1-fpm.sock;ls /run/php/
fastcgi_pass unix:/run/php/php8.3-fpm.sock;Calea socket-ului depinde de versiunea PHP instalată.
Repară eroarea, direct în pagină
nginx ascultă pe portul 8080 și trimite cererile, prin proxy_pass, spre API-ul care rulează deja în fundal. curl http://localhost:8080 afișează 502 Bad Gateway, iar în logul de erori al nginx apare connect() failed (111: Connection refused) while connecting to upstream. Află pe ce port ascultă API-ul, repară /etc/nginx/sites-available/api și reîncarcă nginx.
Indiciu
ss -tlnp îți arată porturile pe care ascultă procesele; compară cu portul din proxy_pass.
Reparația
sudo tail -n 1 /var/log/nginx/error.log
ss -tlnp
sudo sed -i 's/127.0.0.1:3000/127.0.0.1:8000/' /etc/nginx/sites-available/api
sudo nginx -t
sudo systemctl reload nginx
curl -s http://localhost:8080De ce merge
nginx trimitea cererile spre 127.0.0.1:3000, unde nu asculta nimic, deci conexiunea era refuzată (eroarea 111), iar vizitatorul primea 502.
ss -tlnp arată că API-ul (serverul python3) ascultă pe 8000. Cu proxy_pass corectat și reload, nginx ajunge la aplicație, iar curl primește răspunsul ei, {"status":"ok"}.
Alte forme ale mesajului
502 Bad Gateway[error] 1207#1207: *1 connect() failed (111: Connection refused) while connecting to upstream, upstream: "http://127.0.0.1:3000/"upstream prematurely closed connection while reading response header from upstreamconnect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory) while connecting to upstream504 Gateway Time-out
Cum o eviți pe viitor
- După ce pornești aplicația, verifică portul cu
ss -tlnpși testează-o direct:curl http://127.0.0.1:8000. - Ține portul într-un singur loc (variabilă de mediu) și folosește-l și în aplicație, și în nginx.
- Rulează aplicația ca serviciu systemd cu
Restart=on-failure, ca să nu rămână oprită. - La 502, citește întâi
sudo tail /var/log/nginx/error.log.
Întrebări frecvente
Cum deosebesc problema nginx de problema aplicației?
Testează aplicația direct, fără nginx: curl http://127.0.0.1:8000. Dacă nici așa nu răspunde, problema e la aplicație. Dacă răspunde, verifică proxy_pass.
Ce diferență e între 502 și 504?
La 502, aplicația a refuzat conexiunea sau a închis-o greșit. La 504, aplicația a acceptat conexiunea, dar n-a răspuns în timpul permis (proxy_read_timeout).
Erori înrudite
curl: (7) Failed to connect to localhost port 80 after 0 ms: Couldn't connect to server Numele a fost găsit, dar pe portul cerut nu ascultă niciun program (sau un firewall respinge conexiunea). Verifică dacă serviciul rulează (systemctl status nginx) și pe ce port ascultă (ss -tln), pornește-l sau folosește portul corect. nginx: [emerg] bind() to 0.0.0.0:80 failed (98: Address already in use) Alt program ascultă deja pe portul 80, iar un port poate fi ocupat de un singur program. Află cine îl ține cu sudo ss -tlnp | grep ':80 ', oprește-l (de exemplu sudo systemctl disable --now apache2) sau mută unul dintre servere pe alt port. Job for nginx.service failed because the control process exited with error code. Serviciul a încercat să pornească, dar programul s-a oprit cu eroare, de obicei din cauza unei configurări greșite. Citește motivul cu systemctl status nginx și journalctl -xeu nginx (la nginx, sudo nginx -t arată linia greșită), repară și pornește din nou. Învață Linux de la zero, cu exerciții la fiecare lecție
Curs Linux: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
