proxy_pass_error_message

Директива `proxy_pass_error_message` управляет обработкой сообщений об ошибках при передаче запросов проксируемому бэкенду в модуле NGINX Mail Core. — NGINX Mail Core

proxy_pass_error_message
mailmail server
Синтаксисproxy_pass_error_message on | off;
По умолчаниюoff
Контекстmail, mail server
МодульNGINX Mail Core
Аргументыflag

Описание

Директива `proxy_pass_error_message`, при включении, позволяет NGINX возвращать сообщения об ошибках от upstream-сервера непосредственно клиенту, вместо их подавления. По умолчанию NGINX может маскировать подробные ответы об ошибках от проксируемого сервиса, чтобы обеспечить более плавный пользовательский опыт, но включение этой директивы может быть полезно для отладки или в целях прозрачности. Директива может располагаться в контекстах конфигурации `mail` и `server`, влияя на то, как обрабатываются ошибки в почтовых операциях. Если вы включаете эту директиву, установив её в `on`, поведение NGINX меняется и клиенту разрешается получать реальные заголовки и тело ответа об ошибке, как они возвращаются бэкенд-сервисом. Это особенно полезно, когда проксируемый сервер имеет специфическую обработку ошибок, которая может дать представление о проблемах, с которыми сталкивается пользователь. Соответственно, директива принимает булево значение в качестве аргумента: `on` указывает на то, что сообщения об ошибках должны передаваться, а `off` — что нет. Внимательное обдумывание того, когда использовать эту директиву, важно; использование её в рабочем окружении может раскрыть конфиденциальную информацию в сообщениях об ошибках, если не принимать соответствующих мер.

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

mail {
    server {
        listen 25;
        proxy_pass_error_message on;
    }
}

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

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