Cloudflare AWS ALB SSL networking

Cloudflare błąd 521 (Web server is down): jak naprawić, gdy origin to ALB lub EC2

Diagnoza błędu 521 w Cloudflare dla origin na AWS: brak listenera 443 na ALB, niedopasowany tryb SSL/TLS, proces niesłuchający na właściwym porcie i blokady zakresów IP Cloudflare.

Jerzy Kopaczewski ·
Cloudflare zwraca błąd 521, czyli origin aktywnie odmawia połączenia. Połączenie nie wisi bez pdpowiedzi (to byłby 522), tylko ktoś po drugiej stronie je odrzuca. Na AWS najczęściej wynika to z niedopasowania trybu SSL/TLS w Cloudflare do tego, co faktycznie nasłuchuje: ALB bez listenera na porcie 443 przy trybie Full, proces aplikacji, który nie działa albo słucha tylko na 127.0.0.1, albo zapora blokująca część adresów Cloudflare.

Jeśli origin w ogóle nie odpowiada i nic nie odrzuca połączenia, to jest błąd 522. Jeśli połączenie działa, ale odpowiedź jest pusta lub uszkodzona, zajrzyj do błędu 520.

Objawy

Odwiedzający widzą stronę Cloudflare z komunikatem Error 521: Web server is down, i to natychmiast, bez długiego oczekiwania. Po stronie origin żądań z Cloudflare nie widać w logach aplikacji:

curl -sI https://app.example.com/ | head -4
# HTTP/2 521
# server: cloudflare
# cf-ray: 8a1b2c3d4e5f6a7b-WAW

# Bezpośrednio do origin (ALB lub EC2), z pominięciem Cloudflare
curl -svk --connect-timeout 10 \
  --resolve app.example.com:443:$(dig +short my-alb-123456.eu-central-1.elb.amazonaws.com | head -1) \
  https://app.example.com/ 2>&1 | head -15
# "Connection refused" przy próbie połączenia z portem 443 potwierdza 521

Szybka wskazówka: gdy ALB nie ma żadnych zdrowych celów, sam zwraca 503. Jeśli widzisz 503 z server: awselb/2.0, to nie jest 521 i trzeba iść do runbooka o health checkach ALB.

Przyczyna

Według dokumentacji Cloudflare dwie najczęstsze przyczyny to wyłączona aplikacja na origin oraz zablokowane żądania z Cloudflare. W praktyce na AWS wygląda to tak:

  • Brak listenera 443 na ALB przy trybie Full lub Full (strict). W tych trybach Cloudflare łączy się z origin przez HTTPS na porcie 443. ALB, który ma tylko listener 80, odrzuca takie połączenie.
  • Tryb Flexible, a origin słucha tylko na 443 (albo odwrotnie). Flexible łączy się z origin przez HTTP na porcie 80, więc zamknięty port 80 daje 521.
  • Aplikacja nie działa lub słucha na złym interfejsie. Proces padł, restart nie przeszedł, albo serwer nasłuchuje tylko na 127.0.0.1 zamiast na 0.0.0.0. Dotyczy to instancji EC2 podłączonej bezpośrednio, bez ALB.
  • Origin bez certyfikatu pasującego do trybu SSL. W trybach Full origin musi obsługiwać HTTPS, a w Full (strict) mieć ważny certyfikat (ACM lub Cloudflare Origin CA).
  • Blokada zakresów IP Cloudflare przez fail2ban, ModSecurity lub WAF na hoście, często częściowa, więc błąd pojawia się sporadycznie.

Rozwiązanie

Krok 1: Ustal tryb SSL/TLS w Cloudflare

Od trybu zależy, na którym porcie i jakim protokołem Cloudflare łączy się z origin. Sprawdź go w panelu (SSL/TLS, Overview) albo przez API:

curl -s -H "Authorization: Bearer $CF_API_TOKEN" \
  "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/settings/ssl" \
  | python3 -c "import json,sys; print(json.load(sys.stdin)['result']['value'])"
# off | flexible | full | strict
Tryb Połączenie Cloudflare z origin Wymagany port na origin
Flexible HTTP 80
Full HTTPS (certyfikat dowolny) 443
Full (strict) HTTPS (certyfikat ważny lub Origin CA) 443

Krok 2: Sprawdź, czy ALB ma listener na właściwym porcie

ALB_ARN=$(aws elbv2 describe-load-balancers --names my-alb \
  --query 'LoadBalancers[0].LoadBalancerArn' --output text)

aws elbv2 describe-listeners --load-balancer-arn "$ALB_ARN" \
  --query 'Listeners[].[Port,Protocol,DefaultActions[0].Type]' --output table
# Przy trybie Full lub Full (strict) musi być wiersz: 443 | HTTPS

Jeśli listenera 443 brakuje, dodaj go z certyfikatem. Certyfikat z ACM działa w trybie Full (strict) pod warunkiem, że obejmuje nazwę hosta używaną przez Cloudflare. Możesz też zaimportować do ACM certyfikat Cloudflare Origin CA, ale pamiętaj, że jest on zaufany wyłącznie przez Cloudflare, więc origin musi być dostępny tylko przez proxy.

resource "aws_lb_listener" "https" {
  load_balancer_arn = aws_lb.app.arn
  port              = 443
  protocol          = "HTTPS"
  ssl_policy        = "ELBSecurityPolicy-TLS13-1-2-2021-06"
  certificate_arn   = aws_acm_certificate.app.arn

  default_action {
    type             = "forward"
    target_group_arn = aws_lb_target_group.app.arn
  }
}

Krok 3: Sprawdź, czy aplikacja działa i nasłuchuje na właściwym interfejsie

Dotyczy instancji EC2, które przyjmują ruch bezpośrednio:

sudo systemctl status nginx        # lub apache2, php-fpm, aplikacja
sudo ss -tlnp | grep -E ':(80|443)\b'
# Szukaj 0.0.0.0:443 lub [::]:443. Wpis 127.0.0.1:443 oznacza nasłuch tylko lokalny.
sudo tail -n 50 /var/log/nginx/error.log

Jeśli proces pada po restartach lub przy wdrożeniu, to właściwa przyczyna i warto dodać jednostkę systemd z Restart=on-failure oraz alarm na stan instancji.

Krok 4: Wyklucz blokadę zakresów Cloudflare

Zaporę na hoście, ModSecurity i fail2ban sprawdź tak samo jak w runbooku o błędzie 522 (Kroki 3 i 5). Różnica jest taka, że przy 521 blokada jest aktywna: serwer odpowiada odmową, a nie ciszą. Błąd pojawiający się sporadycznie, tylko dla części użytkowników, bardzo często oznacza, że blokada obejmuje tylko niektóre z zakresów Cloudflare.

# Lista zablokowanych adresów (fail2ban 0.11+). Porównaj ją z zakresami z api.cloudflare.com/client/v4/ips
sudo fail2ban-client banned

Krok 5: Uważaj na pętlę przekierowań po zmianie trybu

Z trybem SSL wiąże się jeszcze jedna pułapka: ALB przekierowuje cały ruch z HTTP na HTTPS, a Cloudflare w trybie Flexible łączy się z origin po HTTP, więc dostaje przekierowanie za każdym razem (ERR_TOO_MANY_REDIRECTS). Rozwiązanie to tryb Full (strict) i listener 443 na ALB. Przekierowanie 80 na 443 może zostać dla klientów łączących się z pominięciem Cloudflare.

Weryfikacja

# 1. Origin odpowiada na właściwym porcie i protokole
curl -sk -o /dev/null -w "%{http_code}\n" \
  --resolve app.example.com:443:$(dig +short my-alb-123456.eu-central-1.elb.amazonaws.com | head -1) \
  https://app.example.com/
# Oczekiwane: 200 (lub 301/302 z aplikacji, nie błąd połączenia)

# 2. Strona działa przez Cloudflare
curl -sI https://app.example.com/ | head -3
# Oczekiwane: HTTP/2 200, server: cloudflare

# 3. Tryb strict przechodzi walidację certyfikatu
curl -sv --resolve app.example.com:443:ORIGIN_IP https://app.example.com/ 2>&1 | grep -E "SSL certificate verify|subject:"

Po naprawie dodaj alarm na 521 i 522 w Cloudflare (powiadomienia o błędach origin) albo na metrykę HTTPCode_ELB_5XX_Count w CloudWatch, żeby kolejna awaria nie została odkryta dopiero przez użytkowników.

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

Co oznacza błąd 521 w Cloudflare?

Błąd 521 (Web server is down) oznacza, że serwer origin odmówił połączenia z Cloudflare. Najczęściej aplikacja nie działa albo nie nasłuchuje na porcie, którego oczekuje wybrany tryb SSL/TLS, lub zapora na origin blokuje adresy Cloudflare.

Dlaczego dostaję 521 po przełączeniu trybu SSL na Full?

W trybach Full i Full (strict) Cloudflare łączy się z origin przez HTTPS na porcie 443. Jeśli ALB ma tylko listener 80 albo serwer nie obsługuje HTTPS, połączenie zostaje odrzucone. Dodaj listener HTTPS z certyfikatem z ACM lub Cloudflare Origin CA, zanim przełączysz tryb.

Czy 521 i 503 z ALB to to samo?

Nie. Błąd 521 pochodzi od Cloudflare i oznacza, że połączenie z origin w ogóle nie zostało przyjęte. Kod 503 z nagłówkiem server: awselb/2.0 zwraca sam ALB, gdy połączenie przyjął, ale nie ma zdrowych celów. Pierwszy problem leży w sieci i listenerach, drugi w health checkach i aplikacji.

Powiązane

 

Jerzy Kopaczewski

Cloudflare przed AWS i błędy 52x nie dają spokoju?

Umów bezpłatną 30-minutową rozmowę. Ustawiamy tryby SSL, listenery ALB, certyfikaty i filtrowanie ruchu tak, żeby Cloudflare i AWS współpracowały bez niespodzianek.

Umów rozmowę