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.
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?
Czy za błędem 520 stoi zawsze mój serwer?
Dlaczego ALB nie zwraca 520?
Powiązane
- Cloudflare błąd 522 na AWS: brak odpowiedzi, security group, NACL i DNS
- Cloudflare błąd 521 na AWS: odmowa połączenia, tryb SSL i listener 443
- AWS ALB 502: cele nie przechodzą health check
- Dokumentacja Cloudflare: błąd 520
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.