Generátor pravidel přesměrování

Úloha přesměrování při migraci webu a SEO

Při migraci webových stránek, restrukturalizaci adres URL nebo odstraňování starého obsahu je správné přesměrování klíčovým prvkem pro zachování pozic ve vyhledávačích a zajištění bezproblémové uživatelské zkušenosti. Pokud se změní struktura odkazů, vyhledávače i uživatelé narážejí na nefunkční stránky, což vede ke ztrátě návštěvnosti. Správně nastavená pravidla přesměrování předávají autoritu původních stránek na nové adresy a udržují indexaci webu v pořádku.

Proces konfigurace se liší podle zvoleného stavového kódu:

• 301 Trvalé: Tento kód informuje vyhledávače a prohlížeče, že stránka byla trvale přesunuta na novou adresu. Vyhledávače následně přenášejí hodnocení (link equity) ze staré URL na novou.
• 302 Dočasné: Tento kód indikuje, že adresa je přesunuta pouze dočasně. Vyhledávače si v tomto případě ponechávají v indexu původní URL a nepřenášejí její hodnocení na cílovou adresu.

Formátování CSV souboru pro import

Nástroj zpracovává mapování přesměrování na základě nahraného souboru ve formátu CSV. Aby mohl generátor data správně přečíst, musí soubor splňovat následující specifikace:

• Struktura záhlaví: První řádek souboru musí obsahovat sloupce pojmenované source a target (případně destination). Pokud tyto sloupce chybí, nástroj zobrazí chybu: „Řádek záhlaví musí obsahovat sloupce „source“ a „target“ (nebo „destination“).“
• Zdrojová URL (source): Může se jednat o kompletní absolutní URL s protokolem HTTP nebo HTTPS, nebo o relativní cestu začínající znakem /. Zdrojový hostitel je při zpracování automaticky odstraněn.
• Cílová URL (target / destination): Může být zadána jako kompletní absolutní URL s protokolem HTTP nebo HTTPS, případně jako relativní cesta začínající znakem /.
• Omezení velikosti a počtu: Maximální velikost importovaného souboru musí být pod 5 MB. Nástroj dokáže zpracovat maximálně 2 000 mapování v jednom souboru.

Pravidla zpracování a validace dat

Generátor uplatňuje při analýze CSV souboru přísná pravidla, která předcházejí chybám v konfiguraci serveru. Každý řádek prochází validací, přičemž v případě nesrovnalostí nástroj vypíše konkrétní chybové hlášení:

• Chybějící hodnoty: Každý řádek musí obsahovat jak zdroj, tak cíl. V opačném případě se zobrazí: „Řádek {line} musí obsahovat jak zdroj, tak cíl.“
• Parametry a kotvy: Zdrojové adresy nesmí obsahovat parametry dotazů (query strings) ani kotvy (fragments). Při jejich detekci nástroj ohlásí: „Řádek {line} obsahuje ve zdroji parametry dotazu nebo kotvu. Použijte pouze čistou zdrojovou cestu.“
• Zástupné znaky: Jakékoli regulární výrazy, zástupné znaky (wildcards) nebo vzory cest jsou ve zdrojových adresách zakázány. Systém vyžaduje pouze přesné shody a při porušení vypíše: „Řádek {line} používá zástupné znaky nebo vzory cest. Tento generátor podporuje pouze přesné zdrojové cesty.“
• Duplicity: Každá zdrojová cesta se může v souboru vyskytovat pouze jednou. Pokud se opakuje, zobrazí se chyba: „Řádek {line} opakuje zdrojovou cestu {source}. Každý zdroj se může objevit pouze jednou.“
• Délka URL: Maximální povolená délka jakékoli URL adresy je 2 048 znaků. Při překročení limitu nástroj vrátí chybu: „URL adresa na řádku {line} je delší než 2 048 znaků.“

Syntaxe přesměrování pro Nginx

Nginx vyžaduje pro přesné shody specifickou syntaxi, která zabraňuje nechtěnému přesměrování podadresářů. Generátor pro prostředí Nginx vytváří pravidla využívající regulární výrazy s ukotvením na začátek ^ a konec $ řetězce.

Příklad vygenerovaného pravidla pro trvalé přesměrování (301) z adresy /stara-stranka na /nova-stranka:

rewrite ^/stara-stranka$ /nova-stranka permanent;

Ukotvení zajišťuje, že požadavek na adresu /stara-stranka/podstranka nebude tímto pravidlem ovlivněn.

Syntaxe přesměrování pro Apache

Pro webový server Apache generuje nástroj direktivy určené do souboru .htaccess. Pravidla využívají modul mod_rewrite s přesným ukotvením cesty.

Příklad vygenerovaného zápisu pro trvalé přesměrování (301) z adresy /stara-stranka na /nova-stranka:

RewriteEngine On
RewriteRule ^stara-stranka$ /nova-stranka [R=301,L]

Příznak L (Last) definuje, že při shodě se již nebudou zpracovávat žádná další pravidla.

Syntaxe přesměrování pro Vercel

Konfigurace přesměrování pro platformu Vercel se zapisuje do souboru vercel.json. Vercel standardně při použití přepínače pro trvalé přesměrování vrací stavový kód 308 a pro dočasné kód 307. Aby bylo zajištěno striktní dodržení standardních kódů 301 a 302, generátor explicitně definuje parametr statusCode.

Příklad vygenerované konfigurace v JSON formátu:

{
  "redirects": [
    {
      "source": "/stara-stranka",
      "destination": "/nova-stranka",
      "statusCode": 301
    }
  ]
}

Tímto způsobem je zajištěno, že vyhledávače obdrží přesně definovaný stavový kód 301 nebo 302.

Ochrana osobních údajů a zpracování dat

Bezpečnost vašich dat je plně zajištěna architekturou nástroje. Váš CSV soubor i vygenerovaná pravidla zůstávají ve vašem prohlížeči. Do služby BroBroGo se nic neodesílá. Veškeré parsování, validace a generování kódu probíhá lokálně na vašem zařízení.

---

Často kladené otázky

Jak by měl být CSV soubor naformátován?

Použijte záhlaví se sloupci „source“ a „target“ (případně „destination“). Každý další řádek může obsahovat kompletní zdrojovou URL s HTTP/HTTPS nebo cestu začínající znakem /, a k tomu kompletní nebo relativní cílovou adresu.

Odpovídají vygenerovaná přesměrování přesné shodě (exact match)?

Ano. Výstupy pro Nginx a Apache jsou ukotveny k přesné zdrojové cestě a Vercel obdrží stejnou doslovnou cestu. Zdrojový název hostitele se odstraní; zdrojové parametry dotazů, kotvy a zástupné znaky (wildcards) jsou odmítnuty, protože tato tři prostředí s nimi zacházejí odlišně.

Proč výstup pro Vercel používá parametr statusCode?

Trvalé přesměrování ve Vercelu standardně vrací kód 308 a dočasné 307. Používáme parametr statusCode, aby vaše volba zůstala přesně 301 nebo 302. Standardní nasazení na Vercelu umožňuje celkem 2 048 tras, proto tento nástroj podporuje maximálně 2 000 mapování.