proxy_pass_trailers

Директива `proxy_pass_trailers` управляет обработкой HTTP-трейлеров в ответах upstream.

Синтаксисproxy_pass_trailers on | off;
По умолчаниюoff
Контекстhttp, server, location
Аргументыflag

Описание

Директива proxy_pass_trailers используется в конфигурациях NGINX, чтобы определить, должны ли HTTP-трейлеры (то есть дополнительные заголовки, отправляемые после тела HTTP-ответа) пересылаться от upstream-сервера клиенту. По умолчанию трейлеры могут быть не включены, что означает, что они не будут пересланы в ответе, что влияет на сценарии, где трейлеры необходимы для правильной обработки на стороне клиента.

Когда директива установлена в on, это означает, что сервер NGINX должен разрешать получение трейлеров из ответа upstream и их отправку обратно клиенту. Особенно это важно в приложениях, где информация в трейлерах содержит важные метаданные или детали ответа, которые необходимо обработать после получения тела ответа. Директива действует в контекстах http, server и location, обеспечивая гибкость применения в разных областях конфигурации.

С точки зрения производительности, включение обработки трейлеров может повлечь небольшие накладные расходы, поэтому обычно рекомендуется делать это лишь при крайней необходимости. Каждый трейлер добавляется в ответ после содержимого тела и должен соответствовать стандартам HTTP, чтобы обеспечить совместимость с клиентами, ожидающими такой структуры ответа.

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

http {
    server {
        location /api {
            proxy_pass http://backend;
            proxy_pass_trailers on;
        }
    }
}

Убедитесь, что сервер бэкенда действительно отправляет trailers; в противном случае включение этой директивы не даст никакого эффекта.

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

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