xclient

Директива xclient управляет тем, устанавливать ли заголовок X-Client в IP-адрес удалённого клиента. — NGINX Mail Core

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

Описание

Директива `xclient` используется в NGINX Mail Core для управления включением IP-адреса удалённого клиента в заголовок X-Client исходящих ответов почтового сервера. Это особенно полезно в ситуациях, когда необходимо отслеживание или логирование реального IP-адреса клиента — например, когда запросы проксируются через другой сервер или при реализации мер безопасности, зависящих от знания исходного источника запроса. Когда директива включена, приложение NGINX вставляет IP клиента в поле X-Client заголовков почтового протокола, которое затем может использоваться бэкенд-обработчиком почты или сервисом логирования. Директива принимает флаговый аргумент, позволяющий администраторам переключать это поведение вкл./выкл. Важно правильно настроить эту директиву, чтобы избежать потенциальных проблем с конфиденциальностью, так как раскрытие IP-адресов клиентов может быть неприемлемо в некоторых контекстах. Поддерживаемые контексты для этой директивы — внутри блока mail и в конфигурациях почтового сервера. Это обеспечивает гибкость настройки в зависимости от конкретного развёртывания инстансов сервера, помогая вести логи, отражающие реальные подключения клиентов, и повышая отслеживаемость для различных целей аудита.

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

mail {
    xclient on;
}

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

Неправильная конфигурация может привести к проблемам в обработке заголовков в зависимости от используемого стека почтового сервера.