Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

WordPress / Nginx

502 Bad Gateway w Nginx

Sprawdź połączenie reverse proxy z aplikacją. Przyczyna zwykle jest w logu błędu i adresie upstream.

Środowisko i zakresNginx jako reverse proxy lub brama FastCGI. nginx.conf, port aplikacji i ścieżki logów zależą od instalacji.

Co może być przyczyną?

  • Aplikacja lub PHP-FPM nie działa.
  • proxy_pass albo fastcgi_pass wskazuje niewłaściwy adres lub socket.
  • Upstream zamyka połączenie albo zwraca niepoprawną odpowiedź.

1. Odczytaj log Nginx

Szukaj wpisu z momentu żądania. Connection refused, Permission denied i premature close prowadzą do różnych napraw.

sudo tail -n 80 /var/log/nginx/error.log
sudo nginx -t

2. Sprawdź usługę upstream

Dla aplikacji HTTP sprawdź jej rzeczywisty port z tej samej sieci, w której działa Nginx. Poniższy curl nie służy do testowania portu FastCGI PHP-FPM.

sudo ss -ltnp
curl -I --connect-timeout 5 http://127.0.0.1:8080/

3. Jeśli to PHP-FPM albo Docker

Przy PHP-FPM sprawdź stan właściwej wersji usługi i prawa socketu. Gdy Nginx jest w kontenerze, jego 127.0.0.1 wskazuje ten kontener, a nie host ani inny kontener.

Jak naprawić problem?

  • Popraw adres upstream albo uruchom naprawioną aplikację po analizie jej logów.
  • Dopasuj dostęp użytkownika Nginx do socketu PHP-FPM bez nadawania praw wszystkim.
  • Po zmianie Nginx wykonaj test, a potem reload: sudo nginx -t && sudo systemctl reload nginx. Dla instalacji kontenerowej użyj procedury tego projektu.

Jak potwierdzić naprawę?

Sprawdź stronę przez publiczny adres oraz typową operację aplikacji. W logu nie powinny pojawiać się kolejne 502 dla tych żądań.

curl -I https://example.com/

Czego nie robić?

Nie zwiększaj losowo timeoutów i nie przełączaj PHP-FPM na publiczny port. Najpierw ustal, czy połączenie w ogóle powstaje.

Źródła i dokumentacja

Data publikacji: 24.09.2026.