Cloudflare AWS ALB troubleshooting

Cloudflare błąd 520 (Web server returns an unknown error): jak go znaleźć, gdy origin stoi na AWS

Diagnoza błędu 520 w Cloudflare dla origin na AWS: awarie procesu aplikacji i OOM, zbyt duże nagłówki i cookies, HTTP/2 do origin, Authenticated Origin Pulls oraz porównanie logów ALB z tym, co zobaczył Cloudflare.

Jerzy Kopaczewski ·
Błąd 520 to najbardziej ogólny z błędów Cloudflare: połączenie z origin się udało, ale to, co wróciło, jest puste, urwane albo niezgodne ze standardem HTTP. Na AWS ten błąd rzadko pochodzi z samego ALB, bo ALB zamienia większość awarii celów na własne kody 502, 503 i 504, które Cloudflare po prostu przekazuje. Dlatego 520 zwykle wskazuje na aplikację lub serwer WWW na instancji: proces, który padł w trakcie odpowiedzi, wyczerpaną pamięć, rozdęte nagłówki albo błędnie ustawione HTTP/2.

Jeśli Cloudflare nie może się w ogóle połączyć, to jest błąd 522 (cisza) lub 521 (odmowa połączenia).

Objawy

Strona działa przez część czasu, a potem zwraca Error 520: Web server returns an unknown error. Błąd bywa powtarzalny dla jednego adresu URL albo losowy, a bezpośrednie wejście na origin w przeglądarce potrafi działać:

curl -sI https://app.example.com/problem-url | head -4
# HTTP/2 520
# server: cloudflare
# cf-ray: 8a1b2c3d4e5f6a7b-AMS

# To samo żądanie bezpośrednio do origin
curl -sv --resolve app.example.com:443:$(dig +short my-alb-123456.eu-central-1.elb.amazonaws.com | head -1) \
  https://app.example.com/problem-url -o /dev/null 2>&1 | grep -E "^< HTTP|^< |curl: \("
# Szukaj: pustej odpowiedzi ("Empty reply from server"), urwanego połączenia lub ogromnych nagłówków

Przyczyna

Dokumentacja Cloudflare wymienia kilka typowych przyczyn. Na AWS najczęściej spotykamy:

  • Proces aplikacji pada w trakcie obsługi żądania. Segfault w PHP-FPM, zabity przez jądro proces (OOM killer), restart workerów po wdrożeniu. Połączenie jest zamykane bez odpowiedzi. Szczególnie typowe dla PHP, o czym wprost ostrzega dokumentacja Cloudflare.
  • Nagłówki odpowiedzi większe niż 128 KB, najczęściej przez lawinę ciasteczek (sesje, śledzenie, wtyczki ustawiające po kilkanaście Set-Cookie).
  • Niepoprawna lub pusta odpowiedź: brak linii statusu, brak treści tam, gdzie powinna być, albo niestandardowe nagłówki.
  • Błędnie skonfigurowane HTTP/2 na origin. Cloudflare łączy się po HTTP/2, jeśli origin go ogłasza, a jeśli serwer zaakceptuje połączenie i potem nie obsłuży protokołu, wraca 520.
  • Authenticated Origin Pulls włączone w Cloudflare, ale origin nie jest do tego przygotowany.
  • Zapora lub wtyczka bezpieczeństwa, która ucina połączenia z adresów Cloudflare.

Rozwiązanie

Krok 1: Porównaj, co zobaczył origin, a co Cloudflare

To najszybszy sposób na rozróżnienie awarii aplikacji od problemu z formatem odpowiedzi. W logach ALB (jeśli włączyłeś logi dostępu do S3) znajdź żądanie z czasu błędu i porównaj dwa pola:

elb_status_code target_status_code Co to znaczy
200 200 Origin odpowiedział poprawnie, więc problem to format odpowiedzi (nagłówki, cookies)
502 - Cel zamknął połączenie bez odpowiedzi (awaria procesu). Cloudflare zwykle przekaże wtedy 502, ale warto sprawdzić
brak wpisu brak wpisu Żądanie nie dotarło do ALB, więc patrz runbook o błędzie 522

Jeśli korzystasz z Cloudflare Logpush, pole OriginResponseStatus równe 0 oznacza dwie różne rzeczy. Gdy CacheStatus to hit lub revalidated, Cloudflare nie kontaktował się z origin i wszystko jest w porządku. Gdy CacheStatus to miss lub expired, połączenie z origin się nie powiodło i to ono jest przyczyną 520. Nie wyciągaj wniosków z samego zera, zawsze sprawdź najpierw status cache.

Krok 2: Poszukaj awarii procesu i OOM na instancji

# Zabite procesy przez OOM killer
sudo dmesg -T | grep -i -E "out of memory|killed process" | tail -5

# PHP-FPM: dzieci kończące się sygnałem
sudo journalctl -u php-fpm --since "1 hour ago" | grep -i -E "signal|exited|segfault" | tail -10

# Nginx: urwane połączenia z upstreamem
sudo grep -E "prematurely closed|upstream timed out|connection reset" /var/log/nginx/error.log | tail -10

# Pamięć w czasie błędów (wymaga agenta CloudWatch)
free -m

Jeśli OOM killer zabija workery, napraw przyczynę (limit pamięci na proces, wyciek, za mała instancja), a nie sam objaw.

Krok 3: Sprawdź rozmiar nagłówków i liczbę ciasteczek

curl -sD - -o /dev/null --resolve app.example.com:443:ORIGIN_IP \
  https://app.example.com/problem-url | tee /tmp/headers.txt | wc -c
grep -ci "^set-cookie" /tmp/headers.txt
# Nagłówki powyżej 128 KB powodują 520. W praktyce problem zaczyna się dużo wcześniej,
# jeśli widzisz kilkanaście Set-Cookie albo nagłówki rzędu kilkudziesięciu kilobajtów.

Ogranicz liczbę i rozmiar ciasteczek po stronie aplikacji, wyłącz wtyczki, które ustawiają ich dziesiątki, i przenieś dane sesji do magazynu po stronie serwera zamiast do cookie.

Krok 4: Wyklucz problem z HTTP/2

Wyłącz na próbę HTTP/2 do origin w panelu Cloudflare (Speed, Settings, Protocol Optimization, HTTP/2 to Origin). Jeśli 520 znikają, origin ogłasza HTTP/2, ale nie obsługuje go poprawnie. Sprawdź konfigurację serwera (dla nginx dyrektywę http2 przy listenerze 443) i zaktualizuj oprogramowanie.

Krok 5: Sprawdź Authenticated Origin Pulls

Jeśli AOP jest włączone w Cloudflare, origin musi akceptować certyfikat klienta Cloudflare. Przy ALB oznacza to konfigurację mTLS na listenerze, a przy nginx dyrektywy ssl_client_certificate i ssl_verify_client. Niedopasowanie daje 520. Na czas diagnozy możesz wyłączyć AOP dla testowego hosta.

Krok 6: Tymczasowe obejście i dane dla wsparcia

Żeby odciążyć użytkowników na czas diagnozy, ustaw rekord DNS jako DNS only (szara chmurka). Pamiętaj, że to odsłania adres origin i wyłącza ochronę Cloudflare, więc traktuj to jako rozwiązanie na godziny, nie dni. Jeśli problem trwa, wsparcie Cloudflare potrzebuje: pełnego adresu URL, wartości cf-ray z błędu, wyniku https://twoja-domena/cdn-cgi/trace oraz dwóch plików HAR (z włączonym Cloudflare i z tymczasowo wyłączonym).

Weryfikacja

# 1. Brak 520 na problematycznym adresie (kilka prób)
for i in 1 2 3 4 5; do
  curl -s -o /dev/null -w "%{http_code} " https://app.example.com/problem-url
done; echo
# Oczekiwane: 200 200 200 200 200

# 2. Nagłówki odpowiedzi mieszczą się w rozsądnym rozmiarze
curl -sD - -o /dev/null https://app.example.com/problem-url | wc -c

# 3. Brak zabitych procesów po obciążeniu
sudo dmesg -T | grep -i "killed process" | tail -3

Skonfiguruj powiadomienie Cloudflare o błędach origin oraz alarm w CloudWatch na pamięć instancji. Błąd 520 łatwo zlekceważyć, bo dotyczy “tylko niektórych żądań”, a często jest wczesnym sygnałem, że aplikacja zbliża się do granicy wytrzymałości.

Najczęstsze pytania o błąd 520 w Cloudflare

Co oznacza błąd 520 w Cloudflare?

Błąd 520 oznacza, że serwer origin zwrócił Cloudflare odpowiedź pustą, niepoprawną lub nieoczekiwaną. Połączenie z origin działa, ale to, co z niego wraca, nie da się zinterpretować. Typowe przyczyny to awaria procesu aplikacji, nagłówki większe niż 128 KB, błędne HTTP/2 na origin albo niedopasowane Authenticated Origin Pulls.

Czy za błędem 520 stoi zawsze mój serwer?

W zdecydowanej większości przypadków tak, bo Cloudflare tylko relacjonuje to, co dostał od origin. Zanim zaczniesz szukać problemu po stronie Cloudflare, porównaj odpowiedź uzyskaną bezpośrednio z origin z tą, którą widzi Cloudflare, i sprawdź logi aplikacji oraz OOM killera.

Dlaczego ALB nie zwraca 520?

Kod 520 jest kodem Cloudflare, a nie AWS. ALB zamienia awarie celów na własne kody 502, 503 i 504, które Cloudflare przekazuje dalej. Jeśli widzisz 520 przy origin za ALB, to zwykle Cloudflare nie potrafił zinterpretować odpowiedzi (na przykład z powodu nagłówków) albo ruch trafia do instancji z pominięciem ALB.

Powiązane

 

Jerzy Kopaczewski

Niestabilna aplikacja za Cloudflare na AWS?

Umów bezpłatną 30-minutową rozmowę. Znajdujemy źródło sporadycznych błędów 5xx, od limitów pamięci po konfigurację ALB i Cloudflare, i porządkujemy monitoring tak, żeby problem był widoczny przed klientem.

Umów rozmowę