more_clear_headers

Директива `more_clear_headers` удаляет указанные HTTP-заголовки из исходящего ответа.

Синтаксисmore_clear_headers header1 [header2 ...];
По умолчаниюnone
Контекстhttp, server, location, if in location
Аргументы1+

Описание

Директива more_clear_headers является частью динамического модуля NGINX Headers More, который расширяет функциональность NGINX, позволяя более тонко управлять HTTP-заголовками. Эта директива позволяет очистить или удалить определённые заголовки из ответа, отправляемого клиенту. Её можно использовать для устранения нежелательных стандартных заголовков, таких как Server, X-Powered-By и другие, которые могут раскрывать информацию, которую разработчики предпочитают скрывать по соображениям безопасности или соответствия нормативам.

При использовании more_clear_headers вы можете указать одно или несколько имён заголовков в качестве аргументов. Каждый указанный заголовок будет удалён из ответа, при этом вы можете последовательно использовать несколько директив more_clear_headers, чтобы очистить несколько заголовков одновременно. Директива может использоваться в разных контекстах, включая http, server, location и даже внутри if внутри location, что делает её достаточно гибкой для разных задач конфигурации. Важно отметить, что имена заголовков, которые вы указываете, нечувствительны к регистру, то есть можно использовать эквивалентное имя независимо от регистра, поскольку HTTP-заголовки обычно нечувствительны к регистру.

Если вы хотите условно очищать заголовки на основе определённых критериев, таких как MIME types или коды состояния ответа, вы можете комбинировать эту директиву с другими связанными директивами. Однако имейте в виду, что more_clear_headers не позволяет дополнительно фильтровать по типам MIME или кодам состояния, как это реализовано в некоторых других командах модуля, таких как more_set_headers, которые имеют более продвинутые опции.

Пример конфига

location /example {
    more_clear_headers 'X-Powered-By';
    more_clear_headers 'Server';
}

Убедитесь, что в названиях заголовков нет опечаток: они регистронезависимы, но должны точно совпадать с заголовками в ответе.

Использование этой directive в неправильном контексте может привести к непредвиденному поведению, особенно внутри вложенных locations или при наличии directives.

Удаление некоторых заголовков может повлиять на функциональность или механизмы безопасности вашего приложения.

← Ко всем директивам