Jak provádět serverless přesměrování pomocí Cloudflare Workers

Provádění serverless přesměrování pomocí Cloudflare Workers znamená zachytit požadavek návštěvníka přímo na hraně sítě Cloudflare, aniž by se dotazoval na původní server, a vrátit odpověď s přesměrováním 301, 302 nebo podmíněným přesměrováním. Tento přístup umožňuje rychlé a škálovatelné přesměrování podle domény, cesty URL, země, zařízení, jazyka, kampaně nebo staré stránky, a to bez zásahu do konfigurace webového serveru. Zejména při SEO migracích, změnách domény, kampaních s cílovými stránkami či správě více webů představuje nízkolatenční, centrální a snadno spravovatelné řešení.

Tradiční přesměrování se většinou řeší přes Apache .htaccess, Nginx konfigurace, aplikační kód nebo hostingové panely. Tyto metody stále fungují, ale u webů s vysokou návštěvností, týmu spravujících více domén nebo u projektů, kde je potřeba rozhodovat dynamicky podle lokace, nabízí Cloudflare Workers výrazně větší flexibilitu. Přesměrovací logika totiž běží v nejbližším datacentru Cloudflare k uživateli. Tím se snižuje zátěž původního serveru a zároveň klesá riziko výpadků či špatné konfigurace serverových pravidel, které by mohly ovlivnit výkon.

V tomto průvodci naleznete příklady od základního 301 přesměrování až po přesměrování na základě cesty, parametrů v URL, země, zaměření na mobilní zařízení a hromadné přesměrování. Probereme také, kdy z hlediska SEO použít 301, kdy 302, jak správně testovat a jaké kontroly provést v infrastruktuře Hostragons na úrovni domény, SSL a hostingu. Pro správu domény doporučujeme navštívit Registrace domény a správa DNS, pro zabezpečené připojení řešení SSL certifikátů a pro výkonný hosting Balíčky web hostingu.

Co jsou Cloudflare Workers a proč je používat pro přesměrování?

Cloudflare Workers jsou serverless platformou umožňující spouštět kód v JavaScriptu přímo na okrajové síti Cloudflare. Serverless neznamená, že server neexistuje, ale že se o správu serveru, škálování, údržbu operačního systému a kapacity infrastruktury nemusíte starat vy. Když návštěvník pošle požadavek na váš web, Worker jej zachytí na edge, vykoná vaše pravidla a případně uživatele přesměruje na jinou adresu.

Hlavní výhodou přesměrování pomocí Workers je vysoká míra kontroly. Kromě jednoduchého porovnání URL můžete číst hlavičky požadavku, zemi uživatele, cestu URL, query parametry, user-agent a hodnotu hostitele. Například můžete trvale přesunout starou stránku /produkty/hosting na /web-hosting, přesměrovat uživatele mimo Českou republiku do anglické verze nebo uživatele s určitým parametrem kampaně poslat na speciální landing page.

Tento přístup zároveň zrychluje spolupráci mezi SEO a technickými týmy. Představte si, že migrujete 450 URL ze starého webu na nový. Místo úprav konfigurace serveru, nasazování a komplikovaného rollbacku můžete přesměrovací mapu spravovat přímo v Workeru nebo v externím datovém úložišti KV. Nasazení, testování i případné vrácení změn jsou tak mnohem kontrolovanější.

Rozdíly mezi přesměrováním na serveru a přes Cloudflare Workers

Neexistuje jediný správný způsob pro každý projekt. Pro malé weby s několika přesměrováními může postačovat nástroj v hostingovém panelu. Pokud ale potřebujete složitější logiku, vysoký provoz, více domén či rychlé změny, Cloudflare Workers jsou efektivnější. Přehled základních rozdílů najdete v tabulce níže.

Jednoduché pravidlo: pokud máte málo přesměrování, jednoduché podmínky a plný přístup k serveru, klasické metody budou fungovat dobře. Pokud však řešíte SEO migrace, geografické rozdělení návštěvníků, A/B kampaně nebo správu mnoha domén, Cloudflare Workers přináší větší udržitelnost a pohodlí.

Co je potřeba před začátkem

Pro bezchybné přesměrování pomocí Cloudflare Workers je důležitá technická příprava. Nejprve musí být vaše doména aktivní na Cloudflare a DNS záznamy správně nastavené. Pokud nejsou DNS záznamy označené jako proxyované (oranžová ikona, tzv. „orange cloud“), Worker přesměrování nebude fungovat podle očekávání. Proto zkontrolujte stav proxy u hostitele, na který chcete přesměrování aplikovat.

• Cloudflare účet a aktivní doména pro přesměrování.
• Správné DNS záznamy typu A, CNAME či jiné.
• Aktivní Cloudflare proxy a vhodně nastavený SSL/TLS režim.
• Mapa přesměrování: stará URL, nová URL a HTTP status kód.
• SEO kontrolní seznam: canonical tagy, sitemap, interní odkazy a stav indexace.
• Nástroje pro testování: prohlížeč, curl nebo kontrola HTTP hlaviček.

Z pohledu hostingu je důležité, aby origin server fungoval bez problémů. Worker přesměrování snižuje zátěž originu, ale chybné DNS nebo SSL nastavení nezachrání. Pokud plánujete HTTPS přesměrování, ujistěte se, že na vašem Hostragons hostingu máte aktivní SSL certifikát. Pomocí Jak provést instalaci bezplatného SSL a Přesměrovací operace přes cPanel najdete užitečné návody.

Podrobný návod: Jak vytvořit serverless přesměrování s Cloudflare Workers

1. Vytvoření Workeru

Přihlaste se do Cloudflare panelu, vyberte svůj účet, přejděte do sekce Workers and Pages a založte nový Worker. Cloudflare nabízí výchozí ukázkový kód, který můžete smazat a nahradit vlastním přesměrovacím skriptem. Doporučujeme pojmenovat Worker výstižně, například seo-redirects, domain-migration nebo campaign-router, aby byla správa v budoucnu přehledná.

Základní přesměrovací logika spočívá v zachycení požadavku, vytvoření URL objektu a pokud je splněna podmínka, přesměrování pomocí Response.redirect. Pro trvalé SEO přesměrování použijte kód 301, pro dočasné kampaně či testování 302. Kód 308 je rovněž trvalý, ale pro SEO migrace je nejběžnější 301.

2. Přidání jednoduchého pravidla 301

Nejčastější scénář je trvalý přesun jedné stránky na jinou. Pokud je požadavek na cestu /stara-stranka, přesměrujte uživatele na /nova-stranka s kódem 301. V kódu Workeru čtete hodnotu pathname a kontrolujete ji. Přesměrování proběhne pouze pokud cesta odpovídá, ostatní požadavky pokračují normálně.

Napríklad pokud jste změnili URL strukturu z /hosting-balicky na /web-hosting, přesměrujte starou adresu na novou. Tím dáte vyhledávačům jasný signál o trvalém přechodu. Google během několika týdnů lépe pochopí novou URL, pokud přesměrování není zacyklené a stará URL směřuje přímo na finální cílovou adresu.

3. Definice Worker Route

Samotný kód nestačí, musíte definovat, na jaké adresy se Worker vztahuje. Například route example.com/* pokrývá všechny cesty na hlavní doméně. Pokud chcete pravidlo aplikovat jen na podadresář, použijte například example.com/stary-blog/*. Příliš široký rozsah může způsobit nechtěná přesměrování.

Je dobré nasazení nejdříve otestovat na testovací subdoméně, např. test.example.com/*. Tam zkontrolujte hlavičky a chování přesměrování. Pokud vše funguje, můžete přejít na produkční doménu. Tento krok je zásadní při velkých SEO migracích, aby nedošlo k hromadným chybám.

4. Nasazení a testování HTTP status kódu

Po nasazení Workeru nestačí jen načíst stránku v prohlížeči. Prohlížeč může mít uloženou starou cache. Použijte nástroje pro kontrolu HTTP hlaviček, abyste ověřili, že kód 301 nebo 302 je vrácen správně. Zkontrolujte také hlavičku Location, zda ukazuje na očekávanou novou URL.

• Směřuje stará URL přímo na novou?
• Je kód přesměrování 301 nebo 302 správně nastaven?
• Nevznikají zbytečné řetězce přesměrování z HTTP na HTTPS?
• Jsou varianty s www a bez www konzistentní?
• Je ukončení URL lomítkem sjednocené?
• Dostávají mobilní i desktopoví uživatelé stejný SEO obsah?

Běžné scénáře přesměrování

Přesměrování jedné stránky

Jde o nejjednodušší a nejbezpečnější způsob. Používá se, když stará stránka, například služba, kampaň nebo blogový článek, byla přesunuta na novou adresu. Důležité je, aby obsahově odpovídala nová stránka původnímu záměru. Přesměrování např. starého SSL návodu na hlavní stránku by snížilo uživatelský komfort a SEO signály. Lepší je přesměrovat na odpovídající SSL návod nebo kategorii.

Hromadné přesměrování pomocí mapy URL

Při migraci webu je často potřeba přesměrovat desítky až tisíce URL. V Workeru si můžete vytvořit mapu starých a nových cest. Například /stary-blog/cloudflare-co-je → /blog/cloudflare-co-je. Tento přístup je vhodný pro menší až střední seznamy. Pro tisíce URL je lepší použít Cloudflare KV, R2 nebo externí API pro načítání mapy, což zjednodušuje správu.

Při přípravě hromadného přesměrování doporučujeme vytvořit tabulku v Excelu nebo Google Sheets se třemi sloupci: stará URL, nová URL, status kód. Ujistěte se, že žádná stará URL nevede na více cílů, finální URL vrací stav 200 a není blokována v robots.txt. Častou chybou při SEO migraci je hromadné přesměrování starých URL na nerelevantní stránky, což krátkodobě snižuje chybovost procházení, ale dlouhodobě oslabuje kvalitu signálů.

Přesměrování podle země

Cloudflare umožňuje zjistit zemi, odkud požadavek přichází. Můžete například uživatele z Česka přesměrovat do /cz verze, z Německa do /de. U zeměpisně založených přesměrování je však třeba být opatrný z hlediska SEO. Googlebot většinou prochází web z určitých lokalit a chybná konfigurace může ztížit indexaci různých jazykových verzí. Proto je důležité správně nastavit hreflang tagy, jazykové voliče a oddělené sitemap soubory.

U zeměpisných přesměrování se doporučuje používat spíše dočasné 302 přesměrování, protože jde o dočasné přizpůsobení obsahu podle lokace uživatele, nikoliv o trvalý přesun stránky. Uživatel by také měl mít možnost svůj jazyk či zemi změnit ručně, což zlepšuje uživatelský zážitek.

Přesměrování podle zařízení nebo user-agenta

Dříve bylo běžné posílat mobilní uživatele na speciální stránky, dnes se však preferuje responzivní design. Přesto je možné použít user-agent přesměrování například pro speciální kampaně, landing pages nebo aplikace. I zde je však nutné dbát na SEO konzistenci. Obsah pro mobil i desktop by měl mít stejný účel, protože Google preferuje mobile-first indexing.

Kampaně a přesměrování podle query parametrů

Pro marketingové týmy jsou Worker přesměrování velmi užitečná. Například uživatele s parametrem utm_campaign=blackfriday lze přesměrovat na speciální stránku bez zásahu do původní aplikace. Dbejte však na to, abyste neztratili parametry důležité pro analytiku. Pokud je to potřeba, přeneste je do nové URL nebo správně sledujte v kampaních.

Výběr správného HTTP status kódu: 301, 302, 307 a 308

Volba status kódu není jen technická záležitost, ale předává vyhledávačům informaci o záměru přesunu. 301 znamená trvalý přesun a je nejpoužívanější pro SEO migrace. 302 značí dočasné přesměrování, vhodné pro kampaně, testy nebo geografické přesměrování. 307 zachovává HTTP metodu (například POST), ale není první volbou pro SEO migrace. 308 je trvalé přesměrování s ochranou metody, vhodné pro moderní API a metody.

Zlaté pravidlo pro SEO: používejte 301 pro jasné a trvalé přesuny, 302 pro dočasné, personalizované či podmíněné přesměrování. Vyvarujte se přesměrovacích řetězců – ideální je, aby stará URL vedla přímo na finální cílovou adresu bez mezikroků.

Tipy pro výkon a bezpečnost

Cloudflare Workers jsou rychlé, ale složitá nebo špatně napsaná pravidla mohou způsobit zpoždění a chyby. Udržujte pravidla jednoduchá, vyhýbejte se zbytečně složitým regulárním výrazům a nepřetěžujte kód velkými seznamy. Pro rozsáhlé přesměrovací mapy je vhodnější uložit data v KV store. Zabraňte také nekonečným smyčkám tím, že zkontrolujete, že cílová URL není stejná jako původní host a cesta.

• Určete jasné odpovědnosti za pravidla (SEO, vývoj, marketing).
• Zálohujte mapy přesměrování před změnami.
• Testujte na staging prostředí před nasazením do produkce.
• Ověřte trvalost cílových URL před nasazením 301.
• Po nasazení pravidelně kontrolujte vzorky URL.
• Sledujte 404 chyby a data z Google Search Console.
• Aktualizujte interní odkazy na nové URL.

Bezpečnostně si dejte pozor na otevřené přesměrování, kdy útočník může zneužít parametry jako next, redirect nebo url k přesměrování na nebezpečné stránky. V takovém případě používejte whitelist domén, kam se může přesměrovávat – například jen vlastní domény nebo schválené kampaně.

SSL konfigurace je rovněž zásadní. Pokud používáte Cloudflare Flexible SSL, ale origin server nemá HTTPS, můžete narazit na složité přesměrovací smyčky. Nejbezpečnější je režim Full nebo Full strict, kdy origin server má platný SSL certifikát. Hostragons nabízí SSL řešení, která vám usnadní nastavení: koupit SSL certifikát a Bezpečnost korporátního hostingu.

Důležitá specifika u Hostragons

Při použití Cloudflare Workers na Hostragons je třeba myslet na tři vrstvy: DNS domény, nastavení hostingu a aplikační přesměrování. Nejprve musí být nameservery domény nasměrovány na Cloudflare. Poté DNS záznamy musejí směřovat na Hostragons servery a proxy (oranžový oblak) musí být aktivní.

Dále zkontrolujte, že doména, addon doména či alias jsou v hostingovém panelu správně nastavené. I když probíhá přesměrování na okraji Cloudflare, některé požadavky stále mohou mířit na origin server. Nesprávné nastavení virtuálního hostitele, chybějící SSL nebo špatná root složka může negativně ovlivnit uživatelský zážitek. K tomu pomohou Průvodce přesměrováním domény a Správa cPanel hostingu.

Na aplikační úrovni zkontrolujte, zda CMS jako WordPress, Laravel nebo jiné aplikace nemají vlastní přesměrovací pravidla, například na HTTPS, www nebo jazykové verze. Pokud Worker a aplikace řeší stejné přesměrování, může dojít ke smyčkám nebo zbytečným řetězcům. Nejlepší je mít přesměrování soustředěné na jedné vrstvě – například všechny SEO migrace v Workeru a uživatelská přesměrování v aplikaci.

Testování, monitoring a ladění

Po nasazení přesměrování je monitoring stejně důležitý jako jeho nastavení. V prvních 24 hodinách sledujte klíčové URL, landing pages s největší návštěvností, organické návštěvy a staré URL s externími odkazy. Využívejte Google Search Console pro sledování indexace a reportů uživatelské zkušenosti. Logy serveru, Cloudflare analýzy a data z analytiky pomáhají rychle odhalit chybná přesměrování.

Typické problémy jsou: použití 302 místo 301, přesměrování starých URL na hlavní stránku místo na správnou novou, rozdíly v chování u lomítek na konci URL, velká a malá písmena nebo ztráta parametrů v URL. Především u e-shopů, SaaS a hostingových webů může nesprávné přesměrování přímo ovlivnit konverze.

Po nasazení využijte jednoduchý kontrolní seznam: vyberte náhodné staré URL, otestujte je pomocí nástroje na kontrolu hlaviček, ověřte, že finální stránka vrací stav 200, porovnejte obsah s původním záměrem a zkontrolujte aktualizaci interních odkazů. Těchto pět kroků pomůže vyhnout se většině SEO problémů.

Příklad strategie: Migrace starých hostingových stránek do nové struktury

Představme si, že hostingová firma mění URL strukturu. Staré adresy jako /linux-hosting, /wordpress-hosting-balicky, /ssl-bezpecnost a /domain-check se mění na jednodušší /web-hosting, /wordpress-hosting, /ssl-certifikat a /domain-skontrola. Na Workeru vytvoříte čtyři jasná pravidla s kódem 301. Následně aktualizujete menu, patičku, sitemap a canonical tagy na nové URL.

Cílem není jen správně přesměrovat uživatele, ale také jasně sdělit vyhledávačům odpovídající nové adresy. Pokud by například /linux-hosting šel rovnou na homepage, Google by ztratil kontext stránky. Nová stránka /web-hosting lépe odpovídá původnímu obsahu a úmyslu. Dobrá přesměrovací mapa je proto více než technická záležitost – je součástí SEO strategie.

Často kladené otázky

Jsou přesměrování přes Cloudflare Workers bezpečná pro SEO?

Ano, pokud používáte správné HTTP status kódy a cílové URL jsou přesné. Pro trvalé přesuny doporučujeme 301, pro dočasné či podmíněné 302. Vyvarujte se přesměrovacích řetězců, smyček a neodpovídajících cílů.

Je potřeba, aby origin server fungoval při přesměrování přes Worker?

Pokud Worker přesměrování probíhá kompletně na edge, nemusí origin server odpovídat. Nicméně finální stránka je často na origin serveru nebo jiné infrastruktuře, takže správná funkčnost hostingu, DNS a SSL konfigurace je nutná.

Je lepší použít Cloudflare Page Rules nebo Workers?

Pro jednoduchá přesměrování stačí Page Rules nebo Redirect Rules. Pokud ale potřebujete podmínky podle cesty, země, zařízení, parametrů nebo více domén, Workers nabízí větší flexibilitu a škálovatelnost.

Lze měnit 301 přesměrování po nasazení?

301 je trvalý signál, proto by se neměl často měnit. Prohlížeče i vyhledávače si ho mohou uložit do cache. Před nasazením se ujistěte, že cílová URL je trvalá a odpovídá obsahu.

Lze přes Workers řešit přesměrování mezi www a non-www verzí?

Ano, můžete kontrolovat hodnotu hostitele a přesměrovávat non-www adresy na www nebo opačně. Důležité je nastavit jednotný standard, mít SSL certifikát pokrývající obě varianty a aktualizovat interní odkazy.

Závěr

Serverless přesměrování s Cloudflare Workers je moderní, výkonný a flexibilní způsob, jak řešit SEO migrace, geografické přesměrování, kampaně a správu více domén. Pokud správně zvolíte HTTP kódy, pečlivě připravíte mapu přesměrování a zkontrolujete DNS, SSL a hosting, zvládnete SEO přechody bezpečně a efektivně. Pro menší projekty postačí jednoduchá pravidla, u velkých migrací je klíčové testování, monitoring a dokumentace.

U Hostragons můžete nakonfigurovat domény, hosting a SSL tak, aby Cloudflare Workers měly pevný základ. V případě potřeby navštivte Balíčky web hostingu, Dotaz na doménu a řešení SSL certifikátů a vyberte si optimální řešení pro svůj projekt.