...
Eroare Linux · Procese, servicii, cron și disc

connect() failed (111: Connection refused) while connecting to upstream

Pe scurt

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

Greșit
BASH
location / { proxy_pass http://127.0.0.1:3000; }
# aplicația ascultă pe 8000
Corect
BASH
location / { 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ă

Greșit
BASH
sudo systemctl status api
# Active: failed
Corect
BASH
sudo systemctl restart api
ss -tlnp | grep 8000

Fără proces care ascultă, conexiunea e refuzată. Repară întâi aplicația (jurnalul ei), apoi nginx.

3Socket PHP-FPM cu altă versiune

Greșit
BASH
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
Corect
BASH
ls /run/php/
fastcgi_pass unix:/run/php/php8.3-fpm.sock;

Calea socket-ului depinde de versiunea PHP instalată.

Repară tu

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.

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 upstream
  • connect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory) while connecting to upstream
  • 504 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

← Toate erorile Linux

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ță 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.