Rola przekierowań w migracji stron i SEO
Podczas migracji witryny internetowej, restrukturyzacji struktury adresów URL lub usuwania nieaktualnych treści, kluczowym zadaniem administratora jest zapewnienie ciągłości działania ruchu sieciowego [Source 2]. Nieprawidłowo obsłużone zmiany adresów prowadzą do błędów ładowania stron, co negatywnie wpływa na doświadczenia użytkowników oraz pozycję witryny w wynikach wyszukiwarek [Source 2]. Narzędzie Generator reguł przekierowań automatyzuje proces tworzenia reguł konfiguracyjnych dla serwerów na podstawie przygotowanej listy mapowań.
Wybór odpowiedniego kodu statusu HTTP decyduje o tym, jak roboty indeksujące oraz przeglądarki interpretują zmianę adresu:
- 301 (Stałe) (Stałe): Informuje, że zasób został przeniesiony na stałe pod nowy adres. Przeglądarki zapamiętują to przekierowanie, a wyszukiwarki przenoszą wypracowaną wartość SEO na nowy adres URL.
- 302 (Tymczasowe) (Tymczasowe): Wskazuje, że zmiana adresu ma charakter przejściowy. Przeglądarki nie zapisują tego przekierowania w pamięci podręcznej na stałe, a adres źródłowy zachowuje swoją pozycję w indeksie wyszukiwarki.
Formatowanie plików CSV do importu danych
Narzędzie przetwarza dane wejściowe dostarczone w formacie CSV. Aby import przebiegł pomyślnie, plik musi spełniać określone kryteria strukturalne:
- Wiersz nagłówka: Pierwszy wiersz pliku musi definiować nazwy kolumn. Wymagane jest użycie kolumn o nazwach
sourceoraztarget(alternatywnie zamiasttargetmożna zastosować nazwędestination). - Format adresu źródłowego (source): Może to być pełny adres URL z protokołem HTTP lub HTTPS, bądź też ścieżka względna zaczynająca się od znaku
/. Nazwy hostów są automatycznie usuwane z adresu źródłowego podczas przetwarzania. - Format adresu docelowego (target/destination): Akceptowane są pełne adresy URL HTTP/HTTPS lub ścieżki względne rozpoczynające się od
/. - Ograniczenia rozmiaru i liczby wierszy: Rozmiar pliku CSV nie może przekraczać 5 MB [Source 2]. Narzędzie obsługuje maksymalnie 2 000 mapowań w jednym pliku. Maksymalna długość pojedynczego adresu URL wynosi 2 048 znaków.
Specyfika składni reguł dla Nginx, Apache i Vercel
Wygenerowane reguły różnią się strukturą w zależności od wybranego środowiska sieciowego, dopasowując się do wymagań składniowych poszczególnych platform:
Nginx
Dla serwera Nginx generowane są dyrektywy dopasowania dokładnego. Reguły są zakotwiczone do konkretnej ścieżki źródłowej, co zapobiega przypadkowemu przekierowywaniu adresów o podobnych nazwach. Przykładowy format wyjściowy wykorzystuje instrukcje dopasowania lokalizacji lub bezpośrednie instrukcje przekierowań z zachowaniem wybranego kodu statusu (301 lub 302).
Apache
W przypadku serwera Apache narzędzie generuje reguły przeznaczone do umieszczenia w pliku .htaccess lub głównej konfiguracji serwera. Wykorzystują one moduł mod_rewrite lub dyrektywę Redirect. Reguły są ściśle zakotwiczone do początku i końca ścieżki źródłowej, co gwarantuje, że przekierowanie nastąpi wyłącznie przy dokładnym dopasowaniu adresu.
Vercel
Konfiguracja dla platformy Vercel generowana jest w formacie JSON, gotowym do wklejenia do pliku vercel.json. Narzędzie jawnie definiuje parametr statusCode o wartości 301 lub 302. Jest to istotne, ponieważ domyślny przełącznik stałego przekierowania (permanent) w konfiguracji Vercel generuje kod statusu 308, natomiast przełącznik tymczasowy (temporary) zwraca kod 307. Użycie parametru statusCode pozwala na wymuszenie tradycyjnych kodów 301 i 302.
Ograniczenia i zasady dopasowywania adresów
Generator reguł przekierowań stosuje rygorystyczne zasady walidacji w celu zapewnienia stabilności działania serwerów docelowych:
- Dokładne dopasowanie (Exact Match): Wszystkie generowane reguły są dopasowywane dosłownie. Narzędzie nie obsługuje dopasowań częściowych ani dynamicznych.
- Brak parametrów zapytania i kotwic: Adresy źródłowe zawierające znaki zapytania
?(query strings) lub znaki skrótu#(kotwice/fragmenty) są odrzucane. Do generowania reguł należy używać wyłącznie czystych ścieżek. - Brak znaków wieloznacznych: Narzędzie nie akceptuje znaków dopasowania wzorców (takich jak
*lub wyrażenia regularne) w adresach źródłowych. Każde mapowanie musi wskazywać na konkretną, statyczną ścieżkę. - Unikalność źródeł: Każda ścieżka źródłowa może zostać zdefiniowana w pliku CSV tylko raz. Powielenie źródła skutkuje błędem walidacji.
Prywatność i przetwarzanie danych
Wszystkie operacje związane z odczytem pliku CSV, walidacją wierszy oraz generowaniem kodu konfiguracyjnego są wykonywane lokalnie w przeglądarce użytkownika. Twój plik CSV oraz wygenerowane reguły nie opuszczają przeglądarki. Nic nie jest przesyłane do serwisu BroBroGo.
Najczęściej zadawane pytania (FAQ)
Jak powinien być sformatowany plik CSV?
Plik powinien zawierać wiersz nagłówka z kolumnami „source” (źródło) oraz „target” (cel). Zamiast „target” można również użyć nazwy „destination”. Każdy kolejny wiersz może zawierać pełny adres URL źródła HTTP/HTTPS lub ścieżkę rozpoczynającą się od znaku /, a także pełny lub względny adres docelowy.
Czy wygenerowane przekierowania opierają się na dokładnym dopasowaniu?
Tak. Reguły dla serwerów Nginx i Apache są dopasowywane dokładnie do ścieżki źródłowej, a platforma Vercel otrzymuje tę samą ścieżkę dosłowną. Nazwa hosta w adresie źródłowym jest usuwana; parametry zapytania (query strings), kotwice oraz wzorce wieloznaczne (wildcards) są odrzucane, ponieważ każde z tych trzech środowisk obsługuje je w inny sposób.
Dlaczego konfiguracja dla Vercel korzysta z parametru statusCode?
Domyślne stałe przekierowanie w konfiguracji Vercel zwraca kod 308, a tymczasowe – 307. W wygenerowanym kodzie używamy parametru statusCode, aby zachować dokładnie wybrany kod 301 lub 302. Standardowe wdrożenia Vercel pozwalają na łącznie 2048 tras, dlatego to narzędzie akceptuje do 2000 mapowań.
Jakie błędy mogą uniemożliwić wygenerowanie reguł?
Proces generowania zostanie przerwany, jeśli plik CSV przekroczy rozmiar 5 MB lub będzie zawierał więcej niż 2 000 mapowań [Source 2]. Błędy wystąpią również w przypadku wykrycia duplikatów ścieżek źródłowych, braku nagłówków „source” i „target”/„destination”, obecności parametrów zapytania, kotwic lub znaków wieloznacznych w adresach źródłowych, a także gdy którykolwiek adres URL przekroczy długość 2 048 znaków.