mirror_request_body

Директива 'mirror_request_body' управляет тем, зеркалировать ли тело запроса в NGINX. — NGINX HTTP Core

mirror_request_body
httpserverlocation
Синтаксисmirror_request_body on | off;
По умолчаниюoff
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументыflag

Описание

Директива 'mirror_request_body' включает или отключает зеркалирование тел запросов в конфигурации NGINX. Когда установлена в 'on', она позволяет тело, полученное в текущем запросе, отправлять в новом зеркальном запросе на upstream‑сервер, заданный директивой 'mirror'. Эта функциональность особенно полезна для целей отладки или когда важно сохранить исходный запрос при выполнении с ним некоторых ненавязчивых операций. Зеркалирование тела запроса может повлиять на производительность, поскольку требует дополнительной памяти для буферизации и создает сетевую нагрузку при передаче тела на upstream‑сервер.

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

location /api {
    mirror_request_body on;
    mirror /mirror_endpoint;
}

Убедитесь, что зеркалирование не приводит к непреднамеренной обработке запросов или ухудшению производительности.

Будьте осторожны с большими телами запросов, так как они могут привести к увеличению потребления памяти из-за буферизации.

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