redir

Выполняет HTTP-переадресацию клиента.

Эта директива подразумевает, что соответствующий запрос должен быть отклонен как есть, и клиент должен повторить попытку по другому URL. По этой причине её порядок директивы очень ранний.

Синтаксис

redir [<matcher>] <to> [<code>]

• <to> — целевой адрес. Становится заголовком ответа Location.

• <code> — код HTTP-статуса для переадресации. Может быть:

  • Положительное целое число в диапазоне 3xx или 401

  • temporary для временной переадресации (302, это значение по умолчанию)

  • permanent для постоянной переадресации (301)

  • html для использования HTML-документа для переадресации (полезно для переадресации браузеров, но не API-клиентов)

  • Заполнитель со значением кода статуса

Примеры

Переадресуйте все запросы на https://example.com:

www.example.com {
	redir https://example.com
}

То же самое, но сохраните существующий URI, добавив {uri}:

www.example.com {
	redir https://example.com{uri}
}

То же самое, но постоянно:

www.example.com {
	redir https://example.com{uri} permanent
}

Переадресуйте вашу старую /about-us страницу на вашу новую /about страницу:

example.com {
	redir /about-us /about
	reverse_proxy localhost:9000
}