Jak wykonać bezserwerowe przekierowania z Cloudflare Workers – poradnik SEO

Wykonywanie bezserwerowych przekierowań za pomocą Cloudflare Workers polega na przechwyceniu żądania użytkownika na sieci brzegowej Cloudflare i zwróceniu odpowiedzi z przekierowaniem 301, 302 lub warunkowym, bez konieczności sięgania do serwera źródłowego. Dzięki temu można tworzyć szybkie i skalowalne przekierowania w oparciu o domenę, ścieżkę URL, kraj, urządzenie, język, parametry kampanii czy dopasowania do starych stron, bez modyfikowania konfiguracji serwera. To rozwiązanie sprawdza się szczególnie przy migracjach SEO, zmianach domen, trasowaniu landing page’y kampanii czy zarządzaniu wieloma stronami – zapewnia niskie opóźnienia, centralne zarządzanie i łatwość utrzymania.

Tradycyjne przekierowania realizuje się zwykle przez pliki konfiguracyjne Apache (.htaccess), bloki serwera Nginx, kod aplikacji lub panel hostingowy. Metody te wciąż działają, jednak przy dużym ruchu, zespołach obsługujących wiele domen lub projektach wymagających dynamicznych decyzji w zależności od lokalizacji, Cloudflare Workers oferują większą elastyczność. Logika przekierowań działa wtedy w najbliższym użytkownikowi centrum danych Cloudflare, co odciąża serwer źródłowy i zmniejsza ryzyko błędów powodujących spadki wydajności lub awarie.

W tym poradniku znajdziesz praktyczne przykłady od podstawowego przekierowania 301, przez przekierowania oparte na ścieżkach, parametrach zapytania, kraju czy urządzeniu mobilnym, aż po masowe mapowania URL. Omówimy też, kiedy stosować kody 301, a kiedy 302 z punktu widzenia SEO, na co zwracać uwagę podczas testów oraz jakie kontrole warto wykonać na infrastrukturze Hostragons przy domenach, SSL i hostingu. Warto też zajrzeć do naszych przewodników dotyczących Rejestracja domeny i zarządzanie DNS, Rozwiązania certyfikatów SSL oraz Pakiety hostingu WWW dla kompleksowej obsługi.

Co to jest Cloudflare Workers i dlaczego warto ich używać do przekierowań?

Cloudflare Workers to platforma serverless, która pozwala uruchamiać fragmenty kodu JavaScript na brzegach sieci Cloudflare. „Serverless” nie oznacza braku serwerów, lecz brak konieczności zarządzania nimi przez użytkownika – automatyczne skalowanie, utrzymanie systemu operacyjnego i zasobów odbywa się po stronie Cloudflare. Gdy odwiedzający wysyła żądanie do Twojej strony, Worker przechwytuje je w najbliższym data center, wykonuje zdefiniowaną logikę i – jeśli potrzeba – odsyła użytkownika pod inny adres.

Największą zaletą używania Workers do przekierowań jest pełna kontrola nad warunkami i kontekstem. Możesz sprawdzać nie tylko URL, ale także nagłówki, kraj pochodzenia, ścieżkę, parametry zapytania, user-agent czy host. Przykładowo możesz na stałe przenieść starą stronę /produkty/hosting na /web-hosting, kierować użytkowników spoza Polski do anglojęzycznego katalogu lub przekierowywać ruch z określonym parametrem kampanii na dedykowaną stronę landingową.

W praktyce taka metoda usprawnia współpracę działów SEO i technicznych. Wyobraź sobie migrację 450 URL z jednej strony na drugą. Zamiast modyfikować konfigurację serwera i ryzykować błędy lub przestoje, możesz zarządzać mapą przekierowań w kodzie Worker lub zewnętrznym magazynie KV. To pozwala na łatwiejsze testy, kontrolowane wdrożenia i szybkie cofanie zmian.

Różnice między przekierowaniami na serwerze a Cloudflare Workers

Nie ma jednej uniwersalnej metody – wszystko zależy od potrzeb projektu. Dla niewielkiej strony z kilkoma przekierowaniami wystarczy panel hostingu. Jednak przy złożonych regułach, dużym ruchu, wielu domenach i potrzebie szybkich zmian Workers sprawdzą się lepiej. Poniższa tabela podsumowuje najważniejsze różnice.

Podsumowując: jeśli masz niewiele przekierowań i prostą konfigurację, klasyczne metody będą wystarczające. Jednak przy SEO migracjach, geolokalizacji, kampaniach A/B lub wielu domenach Cloudflare Workers zapewnią większą stabilność i wygodę.

Co przygotować przed rozpoczęciem

Przed wdrożeniem przekierowań z Cloudflare Workers warto zadbać o odpowiednie przygotowanie techniczne, by uniknąć problemów. Przede wszystkim domena musi być aktywna w Cloudflare, a rekordy DNS prawidłowo skonfigurowane. Przekierowania nie zadziałają na rekordach DNS bez włączonej funkcji proxy (szara chmura). Sprawdź więc, czy host, dla którego robisz reguły, ma proxy włączone (pomarańczowa chmura).

• Konto Cloudflare i aktywna domena, na której chcesz robić przekierowania.
• Poprawne rekordy DNS A, CNAME lub inne wskazujące na hosting.
• Włączona funkcja proxy Cloudflare oraz odpowiedni tryb SSL/TLS.
• Mapa przekierowań: stare URL, nowe URL oraz kod statusu.
• Lista kontrolna SEO: tagi kanoniczne, mapa witryny, linki wewnętrzne i indeksacja.
• Narzędzia do testów: przeglądarka, curl lub narzędzia do analizy nagłówków HTTP.

Ważne jest też, aby serwer źródłowy działał poprawnie. Chociaż Worker zmniejsza obciążenie serwera, błędna konfiguracja DNS czy SSL nie zostanie naprawiona automatycznie. Szczególnie przy przekierowaniach HTTPS upewnij się, że certyfikat SSL na Hostragons jest aktywny. Przydatne będą też nasze poradniki Jak przeprowadzić instalację darmowego SSL oraz operacje przekierowania przez cPanel.

Krok po kroku: tworzenie bezserwerowego przekierowania z Cloudflare Workers

1. Utwórz nowego Workera

Zaloguj się do panelu Cloudflare, wybierz konto i przejdź do sekcji Workers and Pages. Utwórz nowego Workera. Domyślnie zobaczysz przykładowy skrypt – usuń go i wprowadź własną logikę przekierowań. Nadaj Workerowi nazwę opisującą jego funkcję, np. seo-redirects, domain-migration lub campaign-router, co ułatwi późniejszą konserwację.

Podstawowa logika to pobranie żądania, utworzenie obiektu URL i sprawdzenie warunku. Jeśli spełniony, użyj Response.redirect, aby odesłać użytkownika pod nowy adres. Dla stałych przekierowań SEO stosuj kod 301, dla tymczasowych (kampanie, testy) 302. Kod 308 też jest opcją dla przekierowań stałych z zachowaniem metody HTTP, lecz najpopularniejszym i najbardziej zrozumiałym dla SEO jest 301.

2. Dodaj prostą regułę przekierowania 301

Najprostszy przypadek to przeniesienie pojedynczej strony na stałe. Logika jest taka: jeśli ścieżka żądania to /stara-strona, przekieruj na /nowa-strona z kodem 301. W Workerze sprawdzasz pathname URL i jeśli pasuje, wykonujesz przekierowanie, a pozostałe żądania przepuszczasz dalej.

Na przykład, jeśli zmieniłeś strukturę kategorii hostingu z /hosting-pakiety na /web-hosting, możesz ustawić przekierowanie, które poinformuje wyszukiwarki o trwałej zmianie. Google zacznie kojarzyć nowy adres w ciągu kilku tygodni, pod warunkiem, że nie tworzysz łańcuchów przekierowań i stare URL od razu prowadzą do ostatecznego celu.

3. Zdefiniuj trasę (route) dla Workera

Sam kod Workera to nie wszystko – musisz określić, w jakich adresach będzie działać. Na przykład route example.com/* obejmie wszystkie ścieżki pod domeną główną. Jeśli chcesz ograniczyć działanie do podfolderu, wpisz np. example.com/stary-blog/*. Pamiętaj, że zbyt szeroki zakres może powodować niechciane przekierowania.

Przed wdrożeniem na produkcję dobrze jest przetestować Worker na subdomenie testowej, np. test.example.com/*. Sprawdź nagłówki i zachowanie przekierowań. Gdy wszystko działa prawidłowo, możesz przenieść regułę na główną domenę. Ta praktyka pomaga uniknąć masowych błędów przy dużych migracjach SEO.

4. Opublikuj i sprawdź kod odpowiedzi HTTP

Po publikacji Workera nie wystarczy tylko sprawdzić, czy strona się ładuje. Cache przeglądarki może pokazywać stare wyniki. Użyj narzędzi do analizy nagłówków HTTP, aby potwierdzić, że otrzymujesz kod 301 lub 302 oraz że nagłówek Location wskazuje na właściwy URL.

• Czy stary URL prowadzi bezpośrednio do nowego?
• Jaki kod przekierowania jest zwracany (301 czy 302)?
• Czy nie występują dodatkowe, niepotrzebne przekierowania z HTTP na HTTPS?
• Czy wersje z www i bez www są spójne?
• Czy stosujesz jednolity sposób użycia ukośnika na końcu URL?
• Czy użytkownicy mobilni i desktopowi widzą ten sam cel SEO?

Popularne scenariusze przekierowań

Przekierowanie pojedynczych stron

To najprostszy i najbezpieczniejszy sposób na start. Używa się go, gdy stara podstrona, wpis blogowy lub kampania przenosi się na nowy adres. Ważne, aby zawartość nowej strony odpowiadała intencji starej. Przekierowanie starego poradnika SSL bezpośrednio na stronę główną może pogorszyć doświadczenie użytkownika i rozproszyć sygnały SEO. Lepiej skierować na najbardziej zbliżony tematycznie poradnik lub kategorię.

Przekierowania masowe z mapą URL

Przy migracji strony często trzeba przekierować dziesiątki lub tysiące adresów. Możesz stworzyć w Workerze obiekt mapy (mapę klucz-wartość) łączący stare ścieżki z nowymi. Na przykład /stary-blog/cloudflare to /blog/cloudflare. To wygodne dla małych i średnich list, ale przy ponad 1000 URL lepiej korzystać z magazynów KV, R2 lub zewnętrznego API, co ułatwia zarządzanie i skalowanie.

Przy masowych przekierowaniach przygotuj tabelę np. w Excelu lub Google Sheets z trzema kolumnami: stary URL, nowy URL i kod statusu. Upewnij się, że każdy stary URL kieruje do jednej, ostatecznej strony zwracającej kod 200 i nie jest blokowany przez robots.txt. Najczęstszym błędem SEO jest masowe kierowanie starych adresów na niepowiązane strony, co może krótkoterminowo zmniejszyć błędy crawlowania, ale długoterminowo osłabić jakość sygnałów.

Przekierowania oparte na kraju

Cloudflare umożliwia odczyt kraju pochodzenia użytkownika. Możesz np. kierować ruch z Polski do katalogu /pl, a z Niemiec do /de. Należy jednak uważać na SEO – Googlebot crawlował może z różnych lokalizacji, a błędna konfiguracja przekierowań geograficznych utrudni indeksowanie różnych wersji językowych. Dlatego ważne jest prawidłowe stosowanie tagów hreflang, linków wyboru języka i oddzielnych map witryn.

W takich przekierowaniach bezpieczniej jest stosować kod 302, by nie sugerować trwałej zmiany. Daje to użytkownikom możliwość zmiany kraju lub języka i nie blokuje właściwej indeksacji.

Przekierowania według urządzenia lub user-agenta

Kiedyś popularne było przekierowywanie mobilnych użytkowników na osobne strony, dziś jednak rekomenduje się responsywne projektowanie. Mimo to przekierowania na przykład do aplikacji mobilnej lub lekkich landing page’y mogą być realizowane na podstawie user-agenta. Trzeba jednak uważać, żeby nie tworzyć niespójnych sygnałów SEO – zawartość na wersjach desktop i mobile powinna mieć podobną intencję.

Pamiętaj też o mobile-first indexing Google – optymalizacja wyłącznie wersji desktopowej nie wystarczy, gdyż to mobilna wersja jest głównym źródłem sygnałów indeksacyjnych.

Przekierowania według parametrów zapytania (kampanie)

Przekierowania oparte na parametrach UTM są bardzo przydatne dla zespołów marketingowych. Możesz np. skierować użytkowników z parametrem utm_campaign=blackfriday na dedykowaną stronę promocji bez konieczności zmian w backendzie. Ważne, aby parametry UTM nie były tracone – jeśli potrzebujesz analityki, przenieś je do nowego URL lub śledź poprawnie w systemach kampanii.

Wybór kodów przekierowań: 301, 302, 307 i 308 w SEO

Wybór kodu statusu HTTP to nie tylko kwestia techniczna – informujesz wyszukiwarki o charakterze przekierowania. 301 oznacza trwałe przeniesienie i jest najczęściej stosowanym kodem w migracjach SEO. 302 to przekierowanie tymczasowe, przydatne w kampaniach, testach czy przekierowaniach regionalnych. 307 zachowuje oryginalną metodę HTTP (np. POST) i jest tymczasowe, a 308 to permanentne przekierowanie z zachowaniem metody.

Zasadnicza zasada SEO: stosuj 301 dla trwałych zmian, a 302 dla tymczasowych, personalizowanych lub warunkowych przekierowań. Unikaj łańcuchów przekierowań – idealnie stary URL powinien kierować bezpośrednio do ostatecznego adresu HTTPS.

Najlepsze praktyki dla wydajności i bezpieczeństwa

Cloudflare Workers są szybkie, ale źle napisane reguły mogą generować opóźnienia i błędy. Zachowaj prostotę, nie komplikuj nadmiernie wyrażeń regularnych i nie umieszczaj ogromnych list przekierowań bez kontroli. Przy bardzo dużych listach lepiej korzystać z magazynów KV, co ułatwia zarządzanie i zwiększa wydajność. Upewnij się też, że przekierowanie nie tworzy pętli – cel nie powinien być taki sam jak obecny host i ścieżka.

• Określ wyraźnego właściciela reguł: SEO, developer lub marketing.
• Przed zmianami wykonaj kopię zapasową mapy przekierowań.
• Testuj na środowisku stagingowym przed wdrożeniem produkcyjnym.
• Przed użyciem 301 upewnij się, że nowy URL jest ostateczny i stabilny.
• Po wdrożeniu sprawdzaj losowe URL ręcznie.
• Monitoruj raporty 404 i dane indeksowania w Google Search Console.
• Aktualizuj wszystkie linki wewnętrzne na nowe adresy.

Z punktu widzenia bezpieczeństwa zwróć uwagę na ryzyko otwartych przekierowań. Nie używaj bezpośrednio parametrów URL takich jak next, redirect czy url do wyznaczania celu, jeśli nie są odpowiednio zweryfikowane. Ogranicz przekierowania tylko do zatwierdzonych domen – np. własnych lub kampanijnych.

Kwestia SSL jest kluczowa. Używanie trybu Flexible SSL bez HTTPS na serwerze źródłowym może powodować pętle przekierowań. Najbezpieczniej jest stosować tryb Full lub Full strict, co wymaga ważnego certyfikatu SSL na serwerze. Hostragons oferuje rozwiązania ułatwiające zakup i konfigurację certyfikatów: Kup certyfikat SSL oraz bezpieczeństwo hostingu dla firm.

Na co zwrócić uwagę korzystając z Hostragons

Przy użyciu Cloudflare Workers na Hostragons warto mieć na uwadze trzy warstwy: DNS domeny, konfigurację hostingu i przekierowania na poziomie aplikacji. Po pierwsze, nameserwery domeny muszą wskazywać na Cloudflare. Następnie rekordy DNS powinny kierować na serwery Hostragons, a rekordy objęte proxy powinny mieć pomarańczową chmurę aktywną.

Po drugie, w panelu hostingowym sprawdź, czy domena, addon domena lub alias są poprawnie skonfigurowane. Mimo że przekierowania następują na brzegu Cloudflare, część żądań może i tak trafiać do serwera źródłowego. Niepoprawna konfiguracja wirtualnych hostów, brak SSL lub błędne katalogi mogą wpłynąć negatywnie na doświadczenie użytkowników. Warto skorzystać z naszych przewodników Poradnik przekierowywania domen oraz zarządzanie hostingiem cPanel.

Po trzecie, sprawdź przekierowania na poziomie aplikacji – WordPress, Laravel czy inne CMS-y mogą mieć własne reguły dotyczące HTTPS, www lub języków. Nakładanie się reguł z Workera i aplikacji może wywoływać pętle lub niepożądane łańcuchy. Najlepiej scentralizować przekierowania – np. migracje SEO realizować w Workers, a przekierowania sesyjne w aplikacji.

Testowanie, monitoring i debugowanie

Po wdrożeniu przekierowań równie ważne jest monitorowanie. W pierwszej dobie zweryfikuj najważniejsze URL – te generujące ruch, landing page’e przynoszące przychody, najczęściej odwiedzane strony organiczne oraz stare adresy z backlinkami. Obserwuj w Google Search Console raporty indeksowania i doświadczenia strony. Analiza logów serwera, statystyk Cloudflare i Google Analytics pozwoli szybciej wychwycić błędy.

Typowe błędy to np. użycie 302 zamiast 301, przekierowanie starego URL na stronę główną zamiast odpowiednią podstronę, niespójności w ukośnikach na końcu adresu, różnice wielkości liter czy utrata parametrów zapytania. W e-commerce, SaaS czy hostingach błędne przekierowania do niewłaściwych produktów lub kategorii mogą bezpośrednio obniżyć konwersję.

Po wdrożeniu warto przygotować listę kontrolną: wybierz losowe stare URL, przetestuj je narzędziem do nagłówków HTTP, sprawdź, czy końcowa strona zwraca kod 200, upewnij się, że zawartość jest zgodna z intencją wyszukiwania, a linki wewnętrzne prowadzą do nowych adresów. Te pięć kroków pozwoli wyeliminować większość problemów technicznych i SEO.

Przykładowa strategia: migracja starych stron hostingowych do nowej architektury informacji

Weźmy konkretny przykład. Firma hostingowa zmienia strukturę URL, przenosząc takie strony jak /linux-hosting, /wordpress-hosting-pakiety, /ssl-bezpieczenstwo i /domain-check na uproszczone odpowiedniki: /web-hosting, /wordpress-hosting, /ssl-certyfikat i /domain-checking. Na Workera przypada cztery reguły 301 przekierowań. Następnie aktualizowane są menu, stopka, sitemap i tagi kanoniczne na nowe URL.

Celem nie jest tylko kierowanie użytkowników na odpowiednie strony, ale także jasne sygnalizowanie wyszukiwarkom powiązań między starymi a nowymi adresami. Jeśli np. /linux-hosting przekierujesz na stronę główną, Google może utracić kontekst tej podstrony. Natomiast /web-hosting jest tematycznie spójne i lepiej przekazuje wartość SEO. Dlatego dobra mapa przekierowań to nie tylko plik techniczny, ale element strategii SEO.

Najczęściej zadawane pytania

Czy przekierowania z Cloudflare Workers są bezpieczne dla SEO?

Tak, jeśli stosujesz odpowiednie kody statusu i kierujesz do właściwych URL. Dla trwałych przeniesień używaj 301, a dla tymczasowych lub warunkowych – 302. Unikaj łańcuchów przekierowań, pętli i przekierowań na niepowiązane strony.

Czy przekierowania z Workera wymagają działającego serwera źródłowego?

Jeśli przekierowanie jest całkowicie obsługiwane na brzegu Cloudflare, nie ma potrzeby dotarcia do serwera źródłowego. Jednak ostateczna strona docelowa może działać na serwerze lub innej infrastrukturze, więc hosting, DNS i SSL muszą być poprawnie skonfigurowane.

Czy lepiej używać Cloudflare Page Rules czy Workers?

Dla prostych pojedynczych przekierowań Page Rules lub Redirect Rules mogą wystarczyć. Jednak gdy potrzebujesz logiki opartej na ścieżkach, kraju, urządzeniu, parametrach czy wielu domenach, Workers są bardziej elastyczne i skalowalne.

Czy można później zmienić przekierowanie 301?

301 to sygnał trwały, więc nie warto go często zmieniać. Przeglądarki i wyszukiwarki cachują takie przekierowania, dlatego przed publikacją upewnij się, że cel jest ostateczny i odpowiada intencji.

Czy można przekierować z www na non-www albo odwrotnie w Workerze?

Tak. Sprawdzając wartość hosta, możesz przekierować wszystkie adresy non-www do wersji z www lub odwrotnie. Ważne jest, by wybrać jeden standard, mieć certyfikat SSL obejmujący obie wersje i aktualizować linki wewnętrzne zgodnie z wybraną konwencją.

Podsumowanie

Wykorzystanie Cloudflare Workers do bezserwerowych przekierowań to nowoczesna metoda, która łączy wysoką wydajność z elastycznością operacyjną. Prawidłowy wybór kodów 301 i 302, staranne przygotowanie mapy przekierowań oraz kompleksowa kontrola warstw DNS, SSL i hostingu pozwala bezpiecznie przeprowadzać migracje SEO. Dla małych projektów wystarczą proste reguły, a przy dużych migracjach kluczowe są testy, monitoring i dokumentacja.

Dzięki odpowiedniej konfiguracji domen, hostingu i SSL na Hostragons możesz solidnie oprzeć przekierowania Cloudflare Workers. W razie potrzeby zapoznaj się z naszymi ofertami Pakiety hostingu WWW, Sprawdzanie domen oraz Rozwiązania certyfikatów SSL, aby dopasować infrastrukturę do swojego projektu.