← Правила Cloudflare / rules / url-forwarding / bulk-redirects

Основные понятия Bulk Redirects

Bulk Redirects включают следующие элементы:

URL redirect: запись, включающая исходный URL-адрес, целевой URL-адрес, код состояния и параметры перенаправления. Перенаправления URL представляют собой отдельные элементы в Bulk Redirect List.
Bulk Redirect List: именованная коллекция, содержащая одно или несколько перенаправлений URL. Чтобы активировать все перенаправления URL из Bulk Redirect List, укажите этот список в Bulk Redirect Rule. Разные Bulk Redirect Rule могут ссылаться на один и тот же Bulk Redirect List.
Bulk Redirect Rule: правило на основе Ruleset Engine, то есть систему, которую Cloudflare использует для вычисления и выполнения правил. С каждым Bulk Redirect Rule связан свой Bulk Redirect List.

Bulk Redirect Rule включает Bulk Redirect List, который содержит одно или несколько перенаправлений URL.

Диаграмма, иллюстрирующая иерархию между Bulk Redirect Rules, Bulk Redirect Lists и URL redirects

Следующий пример определяет Bulk Redirect List с именем list_b с двумя перенаправлениями URL-адресов:

list_b Bulk Redirect List

Исходный URL	Целевой URL	Код состояния
`example.com/about`	`https://example.com/news`	`301` (значение по умолчанию)
`example.com/new_feature`	`https://example.com/soon`	`302`

Следующее правило Bulk Redirect Rule с именем Rule 2, включает редиректы URL в list_b Bulk Redirect List:

Rule 2 Bulk Redirect Rule

Название правила: Rule 2
Связанный список: list_b

URL redirects

URL redirect позволяет настроить исходный URL, целевой URL, код состояния и параметры перенаправления.

При указании исходного URL используйте доступные параметры редиректа вместо подстановочных знаков, которые не поддерживаются. Например, Включить поддомены параметр позволяет настроить одно перенаправление URL, которое применяется как к поддоменам (например, https://b.example.com и https://a.b.example.com) и к apex-домену (корневому домену без поддомена, например, https://example.com). Остальные параметры позволяют указать, как обрабатываются путь и строка запроса исходного URL. Подробнее см. в Как работают Bulk Redirects.

URL redirects представляют собой элементы списков Bulk Redirect Lists.

Bulk Redirect Lists

С помощью Bulk Redirect Lists можно создавать отдельные группы перенаправлений URL для разных целей. Один и тот же Bulk Redirect List можно использовать в одном или нескольких Bulk Redirect Rules.

Bulk Redirect List сам по себе не выполняет никаких перенаправлений: чтобы включить перенаправления из списка, на него нужно сослаться в Bulk Redirect Rule.

Bulk Redirect List не может содержать несколько URL redirect с одинаковым исходным URL.

Подробнее о формате CSV для импорта элементов в Bulk Redirect List см. в Формат CSV-файла для Bulk Redirects.

Bulk Redirect Rules

Bulk Redirect Rules представляют собой правила на основе Ruleset Engine, которые позволяют выполнять одно или несколько перенаправлений URL через Bulk Redirect List.

При настройке Bulk Redirect Rule вы связываете с ним Bulk Redirect List, что включает все перенаправления URL из этого списка. Можно создать отдельное правило для каждого списка либо использовать несколько Bulk Redirect Rules, ссылающихся на один и тот же Bulk Redirect List.

Bulk Redirect Rule, как и все правила на основе Ruleset Engine, имеет действие (что происходит при срабатывании правила) и выражение (условия, которые должны быть выполнены). Помимо этих двух свойств, у него также есть имя, необязательное описание, связанный Bulk Redirect List и ключ.

Выражение

Выражение правила, или выражение фильтра, задает условия, при которых правило срабатывает. По умолчанию применяются все перенаправления URL из указанного списка.

Выражение Bulk Redirect Rule по умолчанию выглядит следующим образом:

http.request.full_uri in $<LIST_NAME>

Это выражение означает, что URL запроса после некоторой базовой нормализация (если Нормализация URL включено), должен соответствовать исходному URL редиректа URL в списке <LIST_NAME> для применения перенаправления.

Чтобы сделать сопоставление перенаправлений URL более точным, можно использовать выражение, отличное от стандартного. Например, если задать для Bulk Redirect Rule следующее выражение, совпадение будет происходить только для запросов из Соединённого Королевства:

ip.src.country == "GB" and http.request.full_uri in $<LIST_NAME>

Сведения о доступных полях см. в Доступные поля и функции.

Ключ

Ключ правила определяет, по какому полю запроса Cloudflare ищет подходящее перенаправление URL в связанном Bulk Redirect List.

Если выражение правила совпадает, Cloudflare сравнивает значение ключа правила с исходным URL каждого перенаправления в связанном Bulk Redirect List, чтобы найти совпадение.

Ключ должен быть либо http.request.full_uri или raw.http.request.full_uri. Используйте raw.http.request.full_uri чтобы сравнить URI, полученный веб-сервером до нормализации, с исходными URL-адресами в Bulk Redirect List.

Поле URI, используемое в ключе, должно совпадать с полем URI, используемым в выражении. Иначе выражение правила может совпасть, а совпадения с исходными URL из списка не будет. Например, если задать для ключа значение http.request.full_uri, поле, используемое в выражении правила, также должно быть http.request.full_uri. И наоборот, если задать ключ равным raw.http.request.full_uri, поле, используемое в выражении, должно быть raw.http.request.full_uri.