Генератор правил редиректа

Принципы работы генератора правил редиректа

При переносе сайтов, изменении структуры URL или удалении устаревших страниц веб-мастерам и разработчикам необходимо настраивать перенаправления. Инструмент «Генератор правил редиректа» автоматизирует этот процесс. Он принимает CSV-файл, содержащий сопоставления старых и новых адресов, и преобразует их в конфигурационный код для выбранной серверной среды.

Процесс генерации состоит из нескольких шагов:

1. Загрузка CSV-файла, содержащего исходные пути и целевые адреса.
2. Выбор типа перенаправления: постоянное или временное.
3. Выбор целевой среды: Nginx, Apache или Vercel.
4. Получение готового кода конфигурации, который можно скопировать или скачать в виде файла.

Все операции по обработке данных выполняются локально. Ваш CSV-файл и сгенерированные правила остаются в браузере. Никакие данные не отправляются на BroBroGo.

Подготовка исходного CSV-файла

Для корректной работы генератора входной файл должен соответствовать строгим правилам форматирования. Инструмент обрабатывает файлы размером менее 5 MB и поддерживает до 2 000 сопоставлений в одном файле.

Требования к структуре и заголовкам

• Строка заголовков: Первая строка файла обязательно должна содержать названия колонок. Допускаются варианты source и target либо source и destination. Если эти колонки отсутствуют, инструмент выведет ошибку: В строке заголовка должны быть колонки source и target (или destination)..
• Разделители: Элементы должны разделяться запятыми. При нарушении структуры кавычек или запятых отображается ошибка: Не удалось разобрать CSV-файл в районе строки {line}. Проверьте кавычки и запятые..

Требования к адресам в строках

Каждая строка после заголовка должна содержать как исходный, так и целевой адрес. В противном случае возникнет ошибка: В строке {line} должны быть указаны и источник, и целевой адрес.. К адресам применяются следующие правила:

• Исходный адрес (Source): Должен быть представлен в виде полного URL-адреса HTTP/HTTPS или пути, начинающегося с /. Имя хоста источника автоматически удаляется при обработке. Использование строк запросов (символ ?), фрагментов (символ #) или шаблонов с подстановочными знаками (например, *) не допускается. При нарушении этих правил выводятся соответствующие ошибки:
  • В строке {line} указан некорректный источник. Используйте URL-адрес HTTP(S) или путь, начинающийся с /.
  • Строка {line} содержит строку запроса или фрагмент в источнике. Используйте только чистый путь источника.
  • Строка {line} содержит подстановочные знаки или символы шаблонов путей. Этот генератор принимает только точные исходные пути.
• Целевой адрес (Destination / Target): Может быть полным URL-адресом HTTP/HTTPS или относительным путем от корня сайта. При некорректном формате выводится ошибка: В строке {line} указан некорректный целевой адрес. Используйте URL-адрес HTTP(S) или путь, начинающийся с /..
• Длина URL: Максимальная длина любого URL-адреса ограничена 2 048 символами. При превышении лимита генерируется ошибка: URL-адрес в строке {line} превышает 2048 символов..
• Уникальность: Каждый исходный путь должен быть уникальным и встречаться в файле только один раз. Дублирование вызывает ошибку: Строка {line} дублирует исходный путь {source}. Каждый исходный путь может встречаться только один раз..

Выбор кода статуса: 301 или 302

Инструмент позволяет выбрать один из двух стандартных кодов состояния HTTP для перенаправления:

• 301 Постоянный (Permanent): Указывает поисковым системам и браузерам, что исходный адрес навсегда перенесен на новый URL. Этот тип редиректа передает ссылочный вес (SEO-показатели) на целевую страницу, что критично при миграции сайтов или изменении структуры URL.
• 302 Временный (Temporary): Сообщает, что документ временно доступен по другому адресу. Поисковые системы продолжают индексировать исходный URL, не передавая его вес новой странице. Применяется при временных технических работах или сезонных акциях.

Особенности синтаксиса для различных сред

Каждая из поддерживаемых сред использует собственный синтаксис для обработки перенаправлений. Сгенерированные правила обеспечивают точное совпадение путей.

Nginx

Для веб-сервера Nginx правила генерируются с привязкой к точному исходному пути. Это достигается за счет использования регулярных выражений с символами начала (^) и конца ($) строки в директиве rewrite или точного соответствия в блоке location. Такой подход предотвращает случайное срабатывание правила для похожих вложенных адресов.

Apache

В конфигурации для Apache (обычно размещаемой в файле .htaccess) генератор создает правила с использованием модуля mod_rewrite или директивы Redirect. Вывод привязывается к точному пути, чтобы гарантировать перенаправление только при полном совпадении запрашиваемого URL.

Vercel

Для платформы Vercel правила генерируются в формате JSON, предназначенном для файла vercel.json. Специфика платформы Vercel заключается в том, что стандартный параметр permanent: true возвращает код 308, а permanent: false — код 307. Чтобы сохранить выбранный пользователем статус 301 или 302, генератор использует явное свойство statusCode.

Ограничения и обработка ошибок

При работе с инструментом действуют следующие ограничения:

• Максимальное количество сопоставлений в одном файле — 2 000. При превышении лимита отображается ошибка: Этот инструмент поддерживает не более {max} сопоставлений одновременно..
• Максимальный размер файла — 5 MB [Source 2]. При попытке загрузить файл большего размера появится ошибка: Этот CSV-файл слишком велик. Выберите файл размером менее {max}..
• Если запуск генерации происходит без выбора файла, выводится сообщение: Сначала выберите CSV-файл.. При выборе файла с неподдерживаемым расширением отображается: Выберите файл с расширением.csv..
• В случае пустых файлов или сбоев в процессе обработки выводятся ошибки: В CSV-файле нет сопоставлений для редиректов., Генерация заняла слишком много времени. Проверьте CSV-файл и попробуйте снова. или Не удалось сгенерировать правила. Проверьте CSV-файл и попробуйте снова..

Часто задаваемые вопросы

Как отформатировать CSV-файл?

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

Являются ли сгенерированные редиректы точными совпадениями?

Да. Вывод для Nginx и Apache привязан к точному исходному пути, и Vercel получает тот же буквальный путь. Имя хоста источника удаляется; исходные строки запросов, фрагменты и шаблоны с подстановочными знаками отклоняются, так как эти три среды обрабатывают их по-разному.

Почему в выводе для Vercel используется statusCode?

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