annotate xml/ru/docs/mail/ngx_mail_proxy_module.xml @ 2678:a4d3e6db81b9

Documented the "proxy_protocol" directive in mail.
author Yaroslav Zhuravlev <yar@nginx.com>
date Wed, 10 Mar 2021 20:36:35 +0000
parents 1f8f12a32ecd
children 7ebe15d6c68d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
2
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
3 <!--
638
179336bb5c03 Fixed copyright lines.
Ruslan Ermilov <ru@nginx.com>
parents: 630
diff changeset
4 Copyright (C) 2006, 2007 Anton Yuzhaninov
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
5 Copyright (C) Nginx, Inc.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
6 -->
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
7
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
9
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
10 <module name="Модуль ngx_mail_proxy_module"
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
11 link="/ru/docs/mail/ngx_mail_proxy_module.html"
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
12 lang="ru"
2678
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
13 rev="5">
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
14
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
15 <section id="directives" name="Директивы">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
16
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
17 <!--
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
18 <directive name="proxy">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
19 <syntax><literal>on</literal> | <literal>off</literal></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
20 <default>off</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
21 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
22 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
23
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
24 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
25 В текущей версии нигде не проверяется.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
26 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
27
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
28 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
29 -->
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
30
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
31
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
32 <directive name="proxy_buffer">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
33 <syntax><value>размер</value></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
34 <default>4k|8k</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
35 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
36 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
37
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
38 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
39 Задаёт размер буфера, используемого при проксировании.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
40 По умолчанию размер одного буфера равен размеру страницы.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
41 В зависимости от платформы это или 4K, или 8K.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
42 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
43
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
44 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
45
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
46
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
47 <directive name="proxy_pass_error_message">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
48 <syntax><literal>on</literal> | <literal>off</literal></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
49 <default>off</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
50 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
51 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
52
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
53 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
54 Определяет, передавать ли клиенту сообщение об ошибке,
641
Ruslan Ermilov <ru@nginx.com>
parents: 638
diff changeset
55 полученное при аутентификации на бэкенде.
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
56 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
57
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
58 <para>
641
Ruslan Ermilov <ru@nginx.com>
parents: 638
diff changeset
59 Обычно, если аутентификация в nginx прошла успешно,
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 641
diff changeset
60 бэкенд не может вернуть ошибку.
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 641
diff changeset
61 Если же он всё-таки возвращает ошибку,
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 641
diff changeset
62 это значит, что произошла ошибка внутри системы.
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
63 В таких случаях сообщение бэкенда может содержать информацию,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
64 которую нельзя показывать клиенту.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
65 Однако для некоторых POP3-серверов ошибка в ответ на правильный пароль
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
66 является штатным поведением.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
67 Например, CommuniGatePro извещает пользователя о
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
68 <link url="http://www.stalker.com/CommuniGatePro/Alerts.html#Quota">переполнении
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
69 ящика</link> или других событиях, периодически выдавая
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
70 <link url="http://www.stalker.com/CommuniGatePro/POP.html#Alerts">ошибку
641
Ruslan Ermilov <ru@nginx.com>
parents: 638
diff changeset
71 аутентификации</link>.
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
72 В этом случае директиву стоит включить.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
73 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
74
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
75 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
76
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
77
2678
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
78 <directive name="proxy_protocol">
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
79 <syntax><literal>on</literal> | <literal>off</literal></syntax>
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
80 <default>off</default>
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
81 <context>mail</context>
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
82 <context>server</context>
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
83 <appeared-in>1.19.8</appeared-in>
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
84
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
85 <para>
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
86 Включает
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
87 <link url="http://www.haproxy.org/download/1.5/doc/proxy-protocol.txt">протокол
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
88 PROXY</link> для соединений с бэкендом.
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
89 </para>
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
90
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
91 </directive>
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
92
a4d3e6db81b9 Documented the "proxy_protocol" directive in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2614
diff changeset
93
2614
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
94 <directive name="proxy_smtp_auth">
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
95 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
96 <default>off</default>
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
97 <context>mail</context>
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
98 <context>server</context>
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
99 <appeared-in>1.19.4</appeared-in>
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
100
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
101 <para>
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
102 Разрешает или запрещает аутентификацию пользователей на SMTP-бэкенде
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
103 при помощи команды <literal>AUTH</literal>.
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
104 </para>
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
105
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
106 <para>
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
107 Если также включён <link id="xclient">XCLIENT</link>,
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
108 то команда <literal>XCLIENT</literal> не будет отправлять
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
109 параметр <literal>LOGIN</literal>.
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
110 </para>
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
111
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
112 </directive>
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
113
1f8f12a32ecd Documented the proxy_smtp_auth directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1526
diff changeset
114
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
115 <directive name="proxy_timeout">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
116 <syntax><value>время</value></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
117 <default>24h</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
118 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
119 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
120
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
121 <para>
1526
7b15698cbdb7 Updated the proxy_timeout directive for mail and stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1070
diff changeset
122 Задаёт <value>таймаут</value> между двумя идущими подряд
7b15698cbdb7 Updated the proxy_timeout directive for mail and stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1070
diff changeset
123 операциями чтения или записи
7b15698cbdb7 Updated the proxy_timeout directive for mail and stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1070
diff changeset
124 на клиентском соединении или соединении с проксируемым сервером.
7b15698cbdb7 Updated the proxy_timeout directive for mail and stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1070
diff changeset
125 Если по истечении этого времени данные не передавались,
7b15698cbdb7 Updated the proxy_timeout directive for mail and stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1070
diff changeset
126 соединение закрывается.
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
127 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
128
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
129 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
130
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
131
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
132 <directive name="xclient">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
133 <syntax><literal>on</literal> | <literal>off</literal></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
134 <default>on</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
135 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
136 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
137
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
138 <para>
1070
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
139 Разрешает или запрещает передачу команды
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
140 <link url="http://www.postfix.org/XCLIENT_README.html">XCLIENT</link>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
141 с параметрами клиента при подключении к SMTP-бэкенду.
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
142 </para>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
143
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
144 <para>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
145 При помощи <literal>XCLIENT</literal> MTA может писать в лог
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
146 информацию о клиенте и применять различные ограничения на основе этих данных.
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
147 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
148
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
149 <para>
1070
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
150 Если команда <literal>XCLIENT</literal> разрешена,
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
151 то при подключении к бэкенду nginx посылает ему следующие команды:
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
152 <list type="bullet">
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
153 <listitem>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
154 <literal>EHLO</literal>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
155 с <link doc="ngx_mail_core_module.xml" id="server_name">именем сервера</link>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
156 </listitem>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
157
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
158 <listitem>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
159 <literal>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
160 XCLIENT
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
161 </literal>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
162 </listitem>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
163
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
164 <listitem>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
165 <literal>EHLO</literal> или <literal>HELO</literal>,
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
166 как её передал клиент
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
167 </listitem>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
168 </list>
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
169 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
170
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
171 <para>
1070
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
172 Если <link doc="ngx_mail_core_module.xml" id="resolver">найденное</link>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
173 по IP-адресу клиента имя указывает на тот же адрес,
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
174 оно передаётся в параметре <literal>NAME</literal>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
175 команды <literal>XCLIENT</literal>.
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
176 Если имя не может быть найдено, указывает на другой адрес,
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
177 или не задан <link doc="ngx_mail_core_module.xml" id="resolver"/>,
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
178 то в параметре <literal>NAME</literal> передаётся
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
179 <literal>[UNAVAILABLE]</literal>.
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
180 Если же в процессе поиска имени или адреса произошла ошибка,
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
181 передаётся <literal>[TEMPUNAVAIL]</literal>.
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
182 </para>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
183
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
184 <para>
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
185 Если команда <literal>XCLIENT</literal> запрещена,
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
186 то при подключении к бэкенду nginx передаёт команду <literal>EHLO</literal> с
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
187 <link doc="ngx_mail_core_module.xml" id="server_name">именем сервера</link>,
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
188 если клиент передал <literal>EHLO</literal>,
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
189 иначе <literal>HELO</literal> с именем сервера.
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
190 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
191
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
192 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
193
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
194 </section>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
195
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
196 </module>