Редиректы

Редиректы перенаправляют посетителей с одного URL на другой. Браузер получает HTTP-ответ с кодом перенаправления и автоматически переходит на новый адрес.

Создание редиректа

1. Откройте проект → Settings → Routing Rules

2. Выберите окружение в правом верхнем углу (Production, Preview и т.д.)

3. На вкладке Redirects нажмите Добавить редирект

4. Заполните поля:

   • Исходный путь — откуда перенаправлять (например, /old-page)
   • Путь назначения — куда перенаправлять (например, /new-page)
   • Статус код — тип перенаправления (301, 302, 307, 308)

5. Выберите окружения, в которых применить правило

6. Нажмите Добавить

Правило применится автоматически в течение нескольких секунд.

Статус коды

Код	Название	Когда использовать
301	Moved Permanently	Страница переехала навсегда. Браузеры и поисковики кэшируют
302	Found	Временное перенаправление. Метод запроса может измениться на GET
307	Temporary Redirect	Временное перенаправление с сохранением метода (POST остаётся POST)
308	Permanent Redirect	Постоянное перенаправление с сохранением метода

Совет

Используйте 301 для постоянных перенаправлений (переезд страницы, ребрендинг). Используйте 307 для временных редиректов, когда важно сохранить HTTP-метод.

Примеры использования

Простое перенаправление

/old-page → /new-page (301)

Запрос /old-page перенаправляется на /new-page.

Перенаправление раздела

/blog/* → /news/:splat (301)

Запрос	Результат
/blog/	/news/
/blog/post-1	/news/post-1
/blog/2024/01/article	/news/2024/01/article

Перенаправление с параметром

/user/:id → /profile/:id (301)

Запрос	Результат
/user/123	/profile/123
/user/john	/profile/john

Заметка

Параметр :id не может содержать /. Для захвата вложенных путей используйте wildcard *.

Перенаправление на внешний ресурс

Редиректы поддерживают только относительные пути. Для перенаправления на внешний домен используйте Rewrites с внешним URL.

Паттерны путей

Точное совпадение

/about → /company/about

Сработает только для /about, но не для /about/team.

Wildcard (*)

/docs/* → /documentation/:splat

Символ * захватывает всё после указанного префикса, включая /.

Именованный параметр (:param)

/product/:slug → /shop/item/:slug

Параметр :slug захватывает один сегмент пути (без /).

Комбинация

/user/:id/posts/* → /profile/:id/articles/:splat

Запрос	Результат
/user/123/posts/new	/profile/123/articles/new
/user/john/posts/2024/best	/profile/john/articles/2024/best

Опция Force

По умолчанию редирект не применяется, если по исходному пути существует файл. Это защищает от случайного перенаправления существующих страниц.

Force выключен (по умолчанию)

Правило: /about → /company (force: false)

Файл /about.html существует?
├─ Да  → Отдаётся файл /about.html
└─ Нет → Редирект на /company

Force включён

Правило: /about → /company (force: true)

Всегда редирект на /company, файл игнорируется

Осторожно

Используйте Force осторожно — это может сделать некоторые страницы недоступными.

Порядок правил

Правила проверяются сверху вниз. Первое совпавшее правило применяется, остальные игнорируются.

Используйте drag-and-drop для изменения порядка.

Правильный порядок:

#	Правило	Комментарий
1	/blog/featured → /featured	Специфичное правило
2	/blog/* → /news/:splat	Общее правило

Неправильный порядок:

#	Правило	Проблема
1	/blog/* → /news/:splat	Перехватит все запросы /blog/*
2	/blog/featured → /featured	Никогда не сработает

Массовое создание

При создании редиректа вы можете выбрать несколько окружений одновременно. Правило будет создано во всех выбранных окружениях с одинаковыми настройками.

Удаление редиректа

1. Найдите редирект в списке
2. Нажмите на иконку удаления справа
3. Подтвердите удаление в диалоге

Заметка

Удаление необратимо. Правило будет удалено из выбранного окружения.

Типичные сценарии

Миграция URL-структуры

При редизайне сайта перенаправляйте старые URL на новые:

/services → /solutions (301)
/services/* → /solutions/:splat (301)
/about-us → /company (301)

Ребрендинг

/acme/* → /newbrand/:splat (301)

Удаление trailing slash

/page/ → /page (301)

Каноникализация

/index → / (301)
/home → / (301)

Отладка

Если редирект не работает:

1. Проверьте порядок правил — более общее правило может перехватывать запросы
2. Проверьте окружение — правило может быть настроено только для Production
3. Проверьте наличие файла — если файл существует и Force выключен, редирект не сработает
4. Подождите несколько секунд — изменения применяются не мгновенно

Для проверки редиректа используйте инструменты разработчика в браузере (вкладка Network) или онлайн-сервисы.

См. также

• Обзор правил роутинга — общая информация
• Rewrites — проксирование без изменения URL
• Заголовки — кастомные HTTP-заголовки