Документация

Edge Rules

Условия, действия и логика маршрутизации.

Edge Rules

Edge rules поддерживают условную оценку с режимами any, all или none и двумя типами полей условий:

  • request_url: Сопоставление пути запроса по регулярному выражению.
  • remote_ip: Сопоставление source IP клиента по регулярному выражению.

Доступные действия:

  • set_request_header: Добавляет заголовок перед proxy-запросом к origin.
  • override_origin_url: Динамически переопределяет upstream origin URL.

В значениях действий можно использовать placeholder пути: %{Path.0}, %{Path.1}, %{Path.0-}.

Подробности выполнения правил

Как работает сопоставление

  • Параметр match на уровне правила задает режим any, all или none для всех условий.
  • Если у конкретного условия match не задан, используется match от родительского правила.
  • Если включено несколько правил, они выполняются в порядке конфигурации.
  • Действия применяются для каждого совпавшего правила, поэтому порядок важен.

Шаблоны и placeholder значения

  • Для request_url используйте regex-шаблоны, например ^/media/.*$ или /iptv-[0-9]+/master\.m3u8$/.
  • remote_ip также поддерживает regex-шаблоны для source IP.
  • В override_origin_url можно использовать path-placeholder, например %{Path.0}.
  • set_request_header удобно применять для upstream auth-заголовков и метаданных маршрутизации.