Mercurial > hg > nginx-site
diff xml/ru/docs/mail/ngx_mail_proxy_module.xml @ 1070:73b31b44d3a0
Updated and simplified the "xclient" directive description.
Implementation details are hidden behind the reference XCLIENT documentation.
Adaptation to mail resolver.
author | Sergey Kandaurov <pluknet@nginx.com> |
---|---|
date | Sat, 08 Feb 2014 17:42:42 +0400 |
parents | 95c3c3bbf1ce |
children | 7b15698cbdb7 |
line wrap: on
line diff
--- a/xml/ru/docs/mail/ngx_mail_proxy_module.xml Sat Feb 08 17:42:42 2014 +0400 +++ b/xml/ru/docs/mail/ngx_mail_proxy_module.xml Sat Feb 08 17:42:42 2014 +0400 @@ -10,7 +10,7 @@ <module name="Модуль ngx_mail_proxy_module" link="/ru/docs/mail/ngx_mail_proxy_module.html" lang="ru" - rev="1"> + rev="2"> <section id="directives" name="Директивы"> @@ -95,39 +95,57 @@ <context>server</context> <para> -Разрешает или запрещает передачу команды <literal>XCLIENT</literal> -при подключении к SMTP-бэкенду. -Для работы команды <literal>XCLIENT</literal> необходим Postfix с -<link url="http://citrin.ru/nginx:xclient-login-patch">патчем</link>, -который добавляет параметр <literal>LOGIN</literal>. -Если не использовать <literal>XCLIENT</literal>, то MTA не сможет писать в лог -<literal>IP</literal>/<literal>HELO</literal>/<literal>LOGIN</literal> -клиента и применять различные ограничения на основе этих данных. +Разрешает или запрещает передачу команды +<link url="http://www.postfix.org/XCLIENT_README.html">XCLIENT</link> +с параметрами клиента при подключении к SMTP-бэкенду. +</para> + +<para> +При помощи <literal>XCLIENT</literal> MTA может писать в лог +информацию о клиенте и применять различные ограничения на основе этих данных. </para> <para> -Если <literal>xclient</literal> включено, -то при подключении к бэкенду nginx сначала передаёт -<example> -EHLO server_name -</example> -потом -<example> -XCLIENT PROTO=ESMTP HELO=client_hello ADDR=192.168.1.1 LOGIN=good_user NAME=[UNAVAILABLE] -</example> -Если клиент при подключении к nginx передал <literal>EHLO</literal>, то в -команде <literal>XCLIENT</literal> передаётся <literal>PROTO=ESMTP</literal>. -В противном случае передаётся <literal>PROTO=SMTP</literal>. -В параметре <literal>ADDR</literal> указывается IP-адрес клиента, -а поскольку nginx не обращается к DNS для получения имени хоста, -то указывается <literal>NAME=[UNAVAILABLE]</literal>. +Если команда <literal>XCLIENT</literal> разрешена, +то при подключении к бэкенду nginx посылает ему следующие команды: +<list type="bullet"> +<listitem> +<literal>EHLO</literal> +с <link doc="ngx_mail_core_module.xml" id="server_name">именем сервера</link> +</listitem> + +<listitem> +<literal> +XCLIENT +</literal> +</listitem> + +<listitem> +<literal>EHLO</literal> или <literal>HELO</literal>, +как её передал клиент +</listitem> +</list> </para> <para> -Если же <literal>xclient</literal> выключено, -то при подключении к бэкенду nginx передаёт -<literal>EHLO</literal>, если его передал клиент, -и <literal>HELO</literal> в остальных случаях. +Если <link doc="ngx_mail_core_module.xml" id="resolver">найденное</link> +по IP-адресу клиента имя указывает на тот же адрес, +оно передаётся в параметре <literal>NAME</literal> +команды <literal>XCLIENT</literal>. +Если имя не может быть найдено, указывает на другой адрес, +или не задан <link doc="ngx_mail_core_module.xml" id="resolver"/>, +то в параметре <literal>NAME</literal> передаётся +<literal>[UNAVAILABLE]</literal>. +Если же в процессе поиска имени или адреса произошла ошибка, +передаётся <literal>[TEMPUNAVAIL]</literal>. +</para> + +<para> +Если команда <literal>XCLIENT</literal> запрещена, +то при подключении к бэкенду nginx передаёт команду <literal>EHLO</literal> с +<link doc="ngx_mail_core_module.xml" id="server_name">именем сервера</link>, +если клиент передал <literal>EHLO</literal>, +иначе <literal>HELO</literal> с именем сервера. </para> </directive>