Szybka odpowiedź: jak skonfigurować Cloudflare przed samodzielnie hostowanym Next.js?
- Przenieś DNS do Cloudflare z proxy i ustaw SSL na Full (Strict).
- Mocny cache włącz tylko dla
/_next/static/, bo te pliki mają hash w nazwie. /api/, panele, webhooki i żądania inne niżGET/HEADustaw jako bypass.- W nginx przywróć IP klienta, ufając
CF-Connecting-IPwyłącznie z zakresów Cloudflare, i zablokuj bezpośredni dostęp do aplikacji na VPS-ie. - Darmowy plan nie zastępuje utrzymania serwera, a tryb SSL
Flexibleodpada przy logowaniu, płatnościach i danych użytkowników.
Darmowy plan Cloudflare obejmuje DNS, proxy, globalną sieć serwerów brzegowych, podstawową ochronę DDoS, SSL/TLS i Cache Rules. Może nie zastąpi poprawnie skonfigurowanego serwera, ale jako front dla samodzielnie hostowanego Next.js sprawdza się bardzo dobrze.
Konfiguracja Cloudflare dla Next.js krok po kroku
1. DNS w Cloudflare i przeniesienie domeny
Podmień serwery nazw domeny na adresy wygenerowane w panelu Cloudflare. Przed wprowadzeniem zmian zweryfikuj kompletność przeniesionych rekordów, ze szczególnym uwzględnieniem MX i TXT, oraz wyłącz DNSSEC u rejestratora. Odświeżenie delegacji zajmuje zazwyczaj do 24–48 godzin i oznacza wyłącznie zmianę dostawcy DNS, bez przenoszenia domeny do nowego rejestratora.
Dodaj rekordy:
(pomarańczowa chmurka) oznacza, że ruch przechodzi przez Cloudflare i korzysta z CDN, ochrony DDoS oraz cache. DNS only (szara chmurka) tylko rozwiązuje DNS, bez proxy, cache i ochrony na serwerach brzegowych.
2. SSL Full (Strict) dla Next.js za Cloudflare
Ustawienia zmienisz w panelu Cloudflare, przechodząc kolejno przez zakładki wskazane strzałkami. Rozpocznij od Dashboard → SSL/TLS → Overview:
- Flexible. SSL działa między użytkownikiem a Cloudflare, ale do Twojego serwera ruch idzie po HTTP. Unikaj tego trybu przy logowaniu, płatnościach i danych użytkownika.
- Full. Ruch jest szyfrowany na całej trasie, ale Cloudflare zaakceptuje też certyfikat wystawiony samodzielnie na serwerze.
- . W tym wariancie, który jest najlepszy, ruch jest szyfrowany na całej trasie, a Cloudflare sprawdza certyfikat serwera źródłowego. Wymaga ważnego certyfikatu na serwerze, np. Let's Encrypt albo Cloudflare Origin CA.
3. Cache Rules dla statycznych plików Next.js
Next.js generuje statyczne pliki w /_next/static/ z hashem zawartości w nazwie. Po zmianie pliku zmienia się też jego adres, więc Cloudflare może przechowywać takie zasoby w cache przez długi czas.
Dashboard → Caching → Cache Rules → Create Rule:
Na początek pozostaw /_next/image poza dodatkowym cache Cloudflare — optimizer Next.js nadal ma własny cache. Jeśli dodasz cache CDN, zachowaj parametry url, w i q w kluczu cache oraz skonfiguruj warianty zgodne z negocjacją Accept i odpowiedzią Vary: Accept. Sprawdź odpowiedzi dla obsługiwanych formatów i ich Content-Type; sam jednodniowy TTL nie wystarczy. Czyszczenie cache CDN nie usuwa kopii z przeglądarki ani cache optimizera. Dla obrazów zmienianych pod tym samym adresem preferuj wersjonowanie URL-i.
Dla własnych plików wersjonowanych ogranicz regułę wyłącznie do zdefiniowanego katalogu, na przykład /assets-versioned/, w którym publikujesz jedynie niezmienne zasoby. Nie zakładaj niezmienności pliku na podstawie samego rozszerzenia czy ciągu znaków wyglądającego jak hash. Jeśli korzystasz z darmowego planu Cloudflare Free, oprzyj regułę na dopasowaniu prefiksu katalogu, ponieważ operator regex matches dostępny jest dopiero w planach Business i Enterprise.
Nie narzucaj też długiego czasu cache na wszystkie zasoby z katalogu /public tylko dlatego, że kończą się na .svg, .png albo .ico. Katalog /_next/static/ jest bezpieczny, gdyż Next.js dokleja hash do nazw plików, ale zasoby pokroju favicon.ico, logo.svg czy banera bez wersji w nazwie mogą zmienić się pod tym samym adresem URL. Dla takich plików potrzebujesz krótszego czasu cache, wersjonowania w nazwie albo czyszczenia pamięci podręcznej po wdrożeniu.
4. Wyłączenie cache dla dynamicznych stron
SSR, Server Actions i API nie powinny trafiać do cache Cloudflare bez bardzo przemyślanej konfiguracji. Zacznij od omijania cache dla dynamicznych ścieżek, a cache dla HTML dodawaj dopiero tam, gdzie rozumiesz konsekwencje dla personalizacji, cookies i rewalidacji.
Powyższe bloki opisują ustawienia w panelu, nie gotowe wyrażenia API. Przy nakładających się Cache Rules ostatnia zgodna reguła rozstrzyga sprzeczne ustawienia, więc bypass umieść po regułach dopuszczających cache. Ta lista ścieżek jest przykładowa: personalizacja i Server Actions mogą występować także pod zwykłymi adresami stron. Cloudflare domyślnie nie cache'uje HTML ani standardowych żądań POST; nie włączaj globalnego Cache Everything.
W Next.js łatwo przeoczyć, że strony statyczne i ISR zwracają nagłówek Cache-Control z dyrektywą s-maxage, którą CDN może respektować. Ma to sens tylko wtedy, gdy dokładnie wiesz, kiedy różni użytkownicy mogą zobaczyć tę samą wersję HTML-a, a kiedy trzeba ją rozdzielić po cookies, wariantach RSC i rewalidacji. revalidatePath() oraz revalidateTag() odświeżą cache po stronie Next.js, natomiast Cloudflare nadal może trzymać własną kopię HTML do końca ustawionego czasu cache. To jest powodem, by domyślnie zostawić HTML poza dodatkową regułą cache Cloudflare, a jeśli zdecydujesz się go cache'ować, zsynchronizuj czas cache z rewalidacją Next.js i wpinaj czyszczenie cache CDN w webhook albo proces CI/CD po zmianie treści.
5. Konfiguracja nginx z Cloudflare
Proxy Cloudflare zmienia IP żądania. Bez dodatkowej konfiguracji nginx widzi adres Cloudflare, a nie użytkownika. Napraw to tak:
Zamiast wklejać zakresy IP na sztywno, wygeneruj je skryptem, który pobiera aktualną listę z oficjalnego źródła Cloudflare:
Plik skryptu powinien należeć do roota, nie być zapisywalny przez użytkownika aplikacji i mieć prawo wykonania. Katalog conf.d musi być dołączany w kontekście http konfiguracji nginx. Po instalacji uruchom skrypt ręcznie i sprawdź logi; dla zadania cron skonfiguruj alert o niepowodzeniu i rotację logu. Przywrócenie pliku po błędzie nie zastępuje kontroli stanu usługi po przeładowaniu.
W tej topologii Nginx pełni rolę ostatniego proxy przed aplikacją Next.js. Po zaufanym odczytaniu prawdziwego adresu IP klienta powinien on nadpisać nagłówek X-Forwarded-For tą zweryfikowaną wartością, zamiast przekazywać dalej potencjalnie sfałszowany łańcuch adresów. Z tego samego powodu nigdy nie rozszerzaj dyrektywy set_real_ip_from na niezaufane zakresy sieci. Warto też pamiętać, że powyższy fragment konfiguracji obsługuje wyłącznie standardowy ruch HTTP oraz streaming odpowiedzi, więc jeśli Twoja aplikacja korzysta z WebSocketów, musisz dopisać warunkową obsługę nagłówków Upgrade i Connection.
Zabezpiecz też wejście do serwera źródłowego. Uruchom Next.js na adresie lokalnym, np. next start --hostname 127.0.0.1, i kieruj proxy_pass na ten sam adres. Nie udostępniaj portu 3000 publicznie. Ogranicz porty HTTP/HTTPS VPS-a do ruchu Cloudflare albo użyj Cloudflare Tunnel; dostęp administracyjny zabezpiecz osobno. Sama pomarańczowa chmurka i Full (Strict) nie blokują połączeń bezpośrednio z IP VPS-a. Przy firewallu uwzględnij odnowienia certyfikatu — np. walidację DNS-01 — oraz aktualizację dozwolonych zakresów. Authenticated Origin Pulls mogą dodatkowo uwierzytelniać połączenia Cloudflare z nginx; to inna funkcja niż walidacja certyfikatu origin w Full (Strict).
Co nadal zostaje po Twojej stronie?
Cloudflare rozwiązuje warstwę wejściową: DNS, TLS, cache na serwerach brzegowych i część ochrony przed ruchem automatycznym. Nie zastępuje jednak platformy wdrożeniowej, dlatego przy samodzielnie hostowanym Next.js nadal odpowiadasz za:
- proces wdrożenia i wycofania błędnej wersji,
- kontrolę zdrowia aplikacji oraz restart po awarii,
- aktualizacje systemu, Node.js, nginx i zależności,
- kopie zapasowe, logi aplikacji i monitoring błędów,
strategię dla
.next/cache, jeśli uruchamiasz więcej niż jedną instancję,przechowywanie uploadów i plików użytkowników poza lokalnym dyskiem VPS-a.
To wszystko zostaje po Twojej stronie niezależnie od Cloudflare i musisz o tym pamiętać.
Ochrona przed DDoS i botami w Cloudflare
Darmowy plan Cloudflare automatycznie chroni przed DDoS, ale warto jednak przejrzeć kilka dodatkowych ustawień:
Ustawienia bezpieczeństwa w Cloudflare
- Ochrona jest zarządzana automatycznie; dawne ustawienie Security Level: Medium nie jest już aktualną instrukcją. Under Attack Mode włączaj doraźnie podczas ataku, po uwzględnieniu wpływu na API.
- Challenge Passage: np. 30 minutes — czas ważności zaliczonego sprawdzenia, niekoniecznie CAPTCHA; dobierz go do aplikacji.
- Browser Integrity Check: On
Rate Limiting na darmowym planie Cloudflare
W panelu Cloudflare ta funkcja nazywa się Rate Limiting, ale w praktyce chodzi po prostu o ograniczanie liczby żądań z jednego źródła w krótkim czasie. Jest to bardzo przydatne przy API, formularzach i endpointach logowania.
Dashboard → Security → WAF → Rate Limiting Rules:
Na Free czas blokady w tym wariancie wynosi 10 sekund. Próg 100 żądań jest przykładem, nie uniwersalnym limitem: dopasuj go do ruchu API, klientów za wspólnym NAT i integracji. Reguła na brzegu nie zastępuje limitowania w aplikacji według konta lub klucza API.
Bot Fight Mode dla ochrony aplikacji
Bot Fight Mode rozważ dopiero po sprawdzeniu wpływu na API, webhooki i monitoring.
Bot Fight Mode pomaga przy prostym ruchu botów, choć nie daje większej kontroli. Przy API, aplikacji mobilnej albo nietypowych integracjach może błędnie wymagać dodatkowej weryfikacji i dlatego lepiej sprawdzają się konkretne reguły WAF i limitowania ruchu. Zwykłego Bot Fight Mode nie ominiesz regułą WAF Skip dla wybranej ścieżki. Jeśli potrzebujesz wyjątków, pozostaw go wyłączonego albo rozważ Super Bot Fight Mode z obsługą reguł Skip.
Optymalizacje wydajności Cloudflare dla Next.js
Minifikacja: dlaczego już jej nie włączasz
Jeśli szukasz w panelu opcji Auto Minify to jej tam nie znajdziesz, ponieważ Cloudflare wycofał ją 5 sierpnia 2024. Stało się to dlatego, że nowoczesne narzędzia budują już zminifikowane pliki, a zysk z dodatkowej minifikacji na serwerach brzegowych był prawie żaden (poniżej 0,1% w sieci Cloudflare). Next.js minifikuje JS i CSS w buildzie i nic więcej nie potrzeba.
Early Hints w Cloudflare
Dashboard → Speed → Optimization → Protocol Optimization:
- Early Hints: On
Samo włączenie opcji nie gwarantuje wysłania wskazówek dla każdej strony. Cloudflare może wysyłać 103 Early Hints na podstawie obsługiwanych nagłówków Link z odpowiedzi serwera źródłowego; zweryfikuj konfigurację i rzeczywistą odpowiedź dla swojej trasy. Dzięki temu przeglądarka może wcześniej zacząć pobierać CSS i JS.
HTTP/3 (QUIC) w Cloudflare
Dashboard → Network:
- HTTP/3 (with QUIC): On
To zwykle przyspiesza zestawianie połączeń, szczególnie na urządzeniach mobilnych i mniej stabilnych sieciach.
Monitoring samodzielnie hostowanego Next.js za Cloudflare
Dashboard → Analytics & Logs nie zastąpi Sentry, logów aplikacji ani monitoringu VPS-a, ale daje szybki obraz tego, co dzieje się przed Twoim serwerem. W samodzielnym hostingu warto zaglądać tam po każdym wdrożeniu, większej zmianie cache i nietypowym skoku ruchu.
- Web Traffic pokazuje liczbę żądań, transfer, kody odpowiedzi HTTP i kraje, z których przychodzi ruch. Przy wzroście
5xxrozróżnij statusy serwera źródłowego od błędów Cloudflare, np. połączenia, TLS lub timeoutu. Sprawdź kod, Ray ID i logi odpowiedniej warstwy. Wzrost4xxmoże wskazywać na boty, błędne linki, źle ustawione przekierowania albo zbyt agresywne reguły bezpieczeństwa. - Security Events pokazuje, co Cloudflare zablokował, przepuścił po dodatkowym sprawdzeniu albo ograniczył regułą limitowania ruchu. To dobre miejsce, żeby sprawdzić, czy Bot Fight Mode albo WAF nie utrudnia życia prawdziwym użytkownikom, integracjom i webhookom.
- Cache pokazuje, jaka część odpowiedzi została obsłużona z cache Cloudflare. Dla stron mocno statycznych wysoki udział trafień może być dobrym sygnałem, ale nie istnieje jeden właściwy próg dla wszystkich aplikacji. Naturalnie, w wypadku aplikacji z logowaniem, panelem klienta i personalizacją ten wynik będzie niższy. Ważniejsze jest wtedy to, czy
/_next/static/, obrazy i publiczne pliki są serwowane z cache, a HTML i API nie trafiają tam przypadkiem.
Po wdrożeniu sprawdź błędy 5xx, udział odpowiedzi z cache i zdarzenia bezpieczeństwa. Jeśli liczba błędów rośnie, ustal najpierw, która warstwa je generuje, a następnie sprawdź połączenie, TLS, VPS, nginx lub proces Next.js zgodnie z rodzajem błędu. Z kolei, jeśli cache nagle spada, zweryfikuj reguły Cloudflare oraz nagłówki Cache-Control. Jeśli pojawia się dużo blokad bezpieczeństwa, przejrzyj konkretne ścieżki i adresy IP, zanim zdecydujesz się na globalne zaostrzenie reguł.


