Генератор правил перенаправлення

Роль перенаправлень у міграції сайтів та SEO

Перенаправлення (redirects) є критично важливим інструментом під час перенесення веб-ресурсів, зміни структури URL-адрес або видалення застарілого контенту [Source 2]. Вони забезпечують збереження авторитету сторінок у пошукових системах (SEO) та запобігають появі помилок 404 для користувачів, які переходять за старими посиланнями [Source 2].

Головне завдання веб-майстра або розробника під час міграції — точно перенаправити старі адреси на нові відповідники [Source 2]. Для цього використовують два основні типи статус-кодів:

• 301 Постійне (Permanent) (Постійне): вказує пошуковим системам, що сторінка назавжди змінила свою адресу. Це дозволяє передати більшу частину посилальної ваги (SEO-авторитету) на новий URL.
• 302 Тимчасове (Temporary) (Тимчасове): повідомляє, що документ тимчасово доступний за іншою адресою. Пошукові роботи залишають у своєму індексі старий URL, не передаючи вагу новому.

Генератор правил перенаправлення автоматизує створення конфігураційних файлів для популярних веб-середовищ, усуваючи потребу писати правила вручну для кожного окремого URL.

Форматування CSV-файлу для імпорту

Для генерації правил необхідно підготувати файл у форматі CSV, який містить таблицю відповідностей між старими та новими адресами. Файл повинен відповідати таким технічним вимогам:

1. Заголовок: Перший рядок файлу обов'язково має містити стовпці source та target (або destination).
2. Формат джерела (Source URL): Може бути повною URL-адресою HTTP або HTTPS, або відносним шляхом, який починається з косої риски /.
3. Формат призначення (Destination URL): Може бути повною URL-адресою HTTP або HTTPS, або коренево-відносним шляхом.
4. Обмеження за розміром: Файл повинен важити менше 5 MB [Source 2].
5. Кількість записів: Інструмент обробляє до 2 000 відповідностей в одному файлі.

Приклад структури CSV-файлу:

source,target
/old-page-one,https://example.com/new-page-one
https://example.com/old-page-two,/new-page-two

Правила обробки та обмеження джерел

Інструмент працює за принципом точного збігу (exact match). Це означає, що згенеровані правила для Nginx та Apache жорстко прив'язуються до конкретного вихідного шляху, а Vercel отримує аналогічний буквальний шлях.

Під час обробки діють такі правила та обмеження:

• Видалення хостнеймів: Імена хостів у вихідних адресах (source) автоматично видаляються, залишаючи лише шлях.
• Заборона параметрів запиту та фрагментів: Вихідні URL-адреси не повинні містити знаків питання ? (рядків запиту) або решіток # (фрагментів). Такі рядки будуть відхилені.
• Заборона символів підстановки: Шаблони з регулярними виразами або символами підстановки (wildcards, наприклад *) не допускаються. Генератор приймає виключно точні статичні шляхи.
• Унікальність джерел: Кожен вихідний шлях (source) може з'являтися у списку лише один раз для запобігання конфліктам перенаправлень.

Синтаксис правил для Nginx, Apache та Vercel

Залежно від обраного веб-середовища, інструмент генерує відповідний синтаксис конфігурації:

Nginx

Для сервера Nginx правила створюються з прив'язкою до точного шляху за допомогою модифікатора = або відповідних директив, що запобігає випадковому спрацьовуванню перенаправлення для схожих вкладених адрес.

Apache

Для серверів Apache генеруються директиви модуля mod_alias (наприклад, Redirect) або правила RewriteRule модуля mod_rewrite. Вони фіксують точний збіг шляху від початку до кінця рядка.

Vercel

Конфігурація для платформи Vercel генерується у форматі JSON для файлу vercel.json. Особливістю платформи є те, що стандартний перемикач permanent: true повертає код 308, а permanent: false — код 307. Щоб забезпечити точне дотримання стандартів 301 або 302, інструмент використовує параметр statusCode у згенерованому JSON-коді.

Конфіденційність та обробка даних

Усі операції з файлами виконуються локально. Ваш CSV-файл та згенеровані правила залишаються у вашому браузері. Нічого не завантажується на BroBroGo. Обробка даних відбувається безпосередньо на вашому пристрої, що виключає передачу вмісту конфігураційних файлів на сторонні сервери.

Часті запитання (FAQ)

Як відформатувати CSV-файл?

Використовуйте рядок заголовка зі стовпцями source та target (замість target також підійде destination). Кожен наступний рядок може містити повну URL-адресу джерела HTTP/HTTPS або шлях, що починається з /, а також повну або відносну адресу призначення.

Чи є згенеровані перенаправлення точними збігами?

Так. Вихідні дані для Nginx та Apache прив'язані до точного вихідного шляху, а Vercel отримує такий самий буквальний шлях. Ім'я хоста джерела видаляється; вихідні рядки запитів, фрагменти та шаблони з підстановками відхиляються, оскільки ці три середовища обробляють їх по-різному.

Чому у вихідних даних для Vercel використовується statusCode?

Постійне перенаправлення у Vercel повертає код 308, а тимчасове — 307. Використовується statusCode, щоб ваш вибір залишався точно 301 або 302. Стандартні розгортання Vercel дозволяють загалом 2048 маршрутів, тому цей інструмент приймає до 2000 відповідностей.

Які обмеження встановлено для файлів та кількості рядків?

Інструмент підтримує завантаження CSV-файлів розміром до 5 MB [Source 2]. Максимальна кількість відповідностей перенаправлень, яку можна обробити за один раз, становить 2 000 рядків. Довжина будь-якої URL-адреси у файлі не повинна перевищувати 2 048 символів.