Generátor pravidiel presmerovania

Správa webových sídiel si často vyžaduje presmerovanie starých adries URL na nové, či už z dôvodu migrácie webu, reštrukturalizácie jeho štruktúry alebo odstraňovania neaktuálneho obsahu. Generátor pravidiel presmerovania umožňuje automatizovať tento proces prekladom zoznamu adries do konfiguračných pravidiel pre webové servery a hostingové platformy.

Tento nástroj spracováva mapovania lokálne priamo vo vašom webovom prehliadači. Váš CSV súbor aj vygenerované pravidlá zostávajú vo vašom prehliadači. Do BroBroGo sa nič neodosiela.

Úloha presmerovaní 301 a 302 pri migrácii a SEO

Pri úprave štruktúry webu alebo prechode na novú doménu je zachovanie autority pôvodných adries URL kľúčové pre optimalizáciu pre vyhľadávače (SEO). Správna voľba stavového kódu definuje, ako vyhľadávače a prehliadače naložia s indexovanou adresou:

• 301 Trvalé: Tento kód signalizuje vyhľadávačom, že pôvodná adresa URL bola natrvalo presunutá na nové miesto. Vyhľadávače zvyčajne prenesú hodnotu odkazu (link juice) zo starej adresy na novú a aktualizujú svoj index.
• 302 Dočasné: Používa sa v prípadoch, keď je presmerovanie aktívne iba obmedzený čas (napríklad počas údržby alebo krátkodobých kampaní). Vyhľadávače si ponechávajú v indexe pôvodnú adresu URL a neprenášajú autoritu na cieľovú adresu.

Formátovanie vstupného CSV súboru

Nástroj vyžaduje na vstupe súbor vo formáte CSV, ktorý definuje vzťahy medzi starými a novými adresami. Pre úspešné spracovanie musí súbor spĺňať nasledujúce štrukturálne pravidlá:

• Hlavička: Prvý riadok musí obsahovať stĺpce s názvami source a target (prípadne destination namiesto target). Ak tieto stĺpce chýbajú, zobrazí sa chyba: Riadok s hlavičkou musí obsahovať stĺpce „source“ a „target“ (alebo „destination“)..
• Zdrojová URL (Source): Môže ísť o úplnú URL adresu s protokolom HTTP alebo HTTPS, alebo o relatívnu cestu začínajúcu znakom /. Zdrojový názov hostiteľa sa z adresy automaticky odstráni.
• Cieľová URL (Destination/Target): Môže byť zadaná ako úplná HTTP/HTTPS adresa alebo ako relatívna cesta od koreňového adresára.
• Limity: Maximálna povolená veľkosť súboru je 5 MB. Nástroj dokáže spracovať najviac 2 000 mapovaní v jednom súbore. Ak dĺžka ktorejkoľvek URL adresy prekročí 2 048 znakov, proces sa preruší.

Každý riadok musí obsahovať oba údaje, inak systém vráti chybu: Riadok {line} vyžaduje zdroj aj cieľ.. Každá zdrojová cesta sa môže v súbore nachádzať iba raz. Duplicity spôsobia chybu: Riadok {line} opakuje zdrojovú cestu {source}. Každý zdroj sa môže zobraziť iba raz..

Pravidlá presnej zhody a obmedzenia zdrojov

Generátor vytvára pravidlá, ktoré sú založené na princípe presnej zhody. To znamená, že vygenerovaný kód pre Nginx, Apache a Vercel presmeruje používateľa iba vtedy, ak navštívi presnú cestu definovanú v stĺpci source.

Z tohto dôvodu platia pre zdrojové adresy prísne obmedzenia:

1. Žiadne dopyty ani fragmenty: Zdrojové adresy nesmú obsahovať parametre za otáznym znakom (?) ani kotvy za mriežkou (#). Pri ich výskyte systém zobrazí chybu: Riadok {line} obsahuje v zdroji dopyt (query string) alebo fragment. Použite iba čistú zdrojovú cestu..
2. Žiadne divoké znaky: Vzory ciest a regulárne výrazy (napr. hviezdičky *) nie sú povolené. Ak ich riadok obsahuje, zobrazí sa chyba: Riadok {line} používa divoké znaky (wildcards) alebo vzory ciest. Tento generátor akceptuje iba presné zdrojové cesty..

Syntax pravidiel pre Nginx, Apache a Vercel

Každé z podporovaných prostredí vyžaduje špecifický formát zápisu pravidiel presmerovania:

Nginx

Pre webový server Nginx sa generujú pravidlá, ktoré využívajú presné mapovanie ciest ukotvené na začiatok a koniec reťazca, aby sa zabránilo nechceným zhodám na podadresároch. Zápis využíva direktívu rewrite alebo bloky location s presnou zhodou, pričom rešpektuje zvolený stavový kód 301 alebo 302.

Apache

Na serveroch Apache sa pravidlá zapisujú do súboru .htaccess. Generátor využíva modul mod_alias s direktívou Redirect alebo mod_rewrite s príznakmi [R=301,L] resp. [R=302,L]. Výstupy sú ukotvené k presnej zdrojovej ceste.

Vercel

Konfigurácia pre platformu Vercel sa definuje vo formáte JSON v súbore vercel.json. Nástroj generuje pole objektov v rámci kľúča redirects.

Vercel natívne pri použití prepínača permanent: true vracia kód 308 a pri permanent: false kód 307. Aby sa zabezpečilo striktné dodržanie štandardných kódov 301 a 302, vygenerovaný JSON kód explicitne definuje parameter statusCode s hodnotou 301 alebo 302.

Riešenie chýb pri spracovaní

Počas nahrávania a analýzy CSV súboru môžete naraziť na nasledujúce chybové hlásenia, ktoré indikujú nesprávny formát dát:

• Vyberte súbor s príponou.csv. — Súbor nemá správnu príponu.
• Tento CSV súbor je príliš veľký. Vyberte súbor menší ako {max}. — Súbor presahuje limit 5 MB.
• Súbor CSV neobsahuje žiadne mapovania presmerovaní. — Súbor je prázdny alebo neobsahuje platné riadky.
• Súbor CSV sa nepodarilo spracovať v blízkosti riadku {line}. Skontrolujte úvodzovky a čiarky. — Syntaktická chyba v štruktúre CSV.
• Riadok {line} obsahuje neplatný zdroj. Použite HTTP(S) URL adresu alebo cestu začínajúcu na /. — Zdroj nespĺňa formát cesty alebo URL.
• Tento nástroj podporuje naraz maximálne {max} mapovaní. — Súbor obsahuje viac ako 2 000 riadkov s mapovaniami.

Často kladené otázky (FAQ)

Ako mám naformátovať CSV súbor?

Použite riadok s hlavičkou obsahujúcou stĺpce „source“ a „target“ (funguje aj „destination“ namiesto target). Každý ďalší riadok môže obsahovať úplnú zdrojovú URL adresu s HTTP/HTTPS alebo cestu začínajúcu na /, a k tomu úplný alebo relatívny cieľ.

Sú vygenerované presmerovania presnou zhodou?

Áno. Výstupy pre Nginx a Apache sú naviazané na presnú zdrojovú cestu a Vercel dostáva rovnakú doslovnú cestu. Zdrojový názov hostiteľa sa odstráni; zdrojové dopyty (query strings), fragmenty a vzory s divokými znakmi (wildcards) sú odmietnuté, pretože tieto tri prostredia s nimi narábajú odlišne.

Prečo výstup pre Vercel používa parameter statusCode?

Trvalé presmerovanie vo Verceli generuje kód 308 a dočasné kód 307. Používa sa parameter statusCode, aby vaša voľba zostala presne 301 alebo 302. Štandardné nasadenia na Vercel umožňujú celkovo 2 048 smerovaní, preto tento nástroj akceptuje maximálne 2 000 mapovaní.

Kde prebieha spracovanie mojich údajov?

Všetky operácie prebiehajú lokálne vo vašom webovom prehliadači. Žiadne dáta z CSV súboru sa neodosielajú na servery BroBroGo, čím je zaistené súkromie vašich konfiguračných údajov.