smtp_capabilities

Директива smtp_capabilities настраивает SMTP-возможности, объявляемые почтовым сервером NGINX. — NGINX Mail Core

smtp_capabilities
mailmail server
Синтаксисsmtp_capabilities capability1 capability2 ...;
По умолчаниюnone
Контекстmail, mail server
МодульNGINX Mail Core
Аргументы1+

Описание

Директива smtp_capabilities используется в контексте почтового сервера NGINX, чтобы указать, какие возможности сервер будет объявлять клиентам во время SMTP-сессии. Эта директива принимает один или несколько аргументов, которые представляют поддерживаемые функции SMTP, такие как AUTH, EXPN и другие. По умолчанию NGINX не будет объявлять никаких возможностей, если эта директива явно не задана. При определении директивы smtp_capabilities необходимо тщательно продумать функции, которые вы хотите включить. Каждая указанная возможность будет включена в ответ EHLO во время SMTP-рукопожатия, информируя клиента о доступных ему функциях. Это может повысить совместимость с различными почтовыми клиентами, которые полагаются на конкретные функции SMTP. Чтобы клиенты могли эффективно использовать сервер, следует указать все необходимые возможности. Однако важно объявлять только те возможности, которые действительно поддерживаются конфигурацией сервера, поскольку иначе это может привести к путанице и ухудшению пользовательского опыта клиентов, пытающихся использовать неподдерживаемые функции. Параметры для директивы smtp_capabilities должны быть правильно отформатированы, и директива должна располагаться в соответствующем контексте почтового сервера, чтобы вступить в силу. Следует соблюдать правильный синтаксис, чтобы избежать неправильной конфигурации. Каждая возможность должна разделяться пробелами, и важно убедиться, что пробелы и доступные опции введены без непреднамеренных ошибок или упущений.

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

mail {
    server {
        listen 25;
        smtp_capabilities AUTH LOGIN PLAIN; 
    }
}

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

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