Mercurial > hg > nginx-site

comparison xml/ru/docs/mail/ngx_mail_proxy_module.xml @ 630:a235ce0f8eef

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Initial mail proxy server documentation in Russian. Obtained from Anton Yuzhaninov.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 15 Aug 2012 07:56:36 +0000
parents
children 179336bb5c03
comparison
equal deleted inserted replaced
629:7e4805858796 630:a235ce0f8eef
1 <?xml version="1.0"?>
2
3 <!--
4 Copyright (C) Anton Yuzhaninov 2006,2007
5 Copyright (C) Nginx, Inc.
6 -->
7
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9
10 <module name="Модуль ngx_mail_proxy_module"
11 link="/ru/docs/mail/ngx_mail_proxy_module.html"
12 lang="ru"
13 rev="1">
14
15 <section id="directives" name="Директивы">
16
17 <!--
18 <directive name="proxy">
19 <syntax><literal>on</literal> | <literal>off</literal></syntax>
20 <default>off</default>
21 <context>mail</context>
22 <context>server</context>
23
24 <para>
25 В текущей версии нигде не проверяется.
26 </para>
27
28 </directive>
29 -->
30
31
32 <directive name="proxy_buffer">
33 <syntax><value>размер</value></syntax>
34 <default>4k|8k</default>
35 <context>mail</context>
36 <context>server</context>
37
38 <para>
39 Задаёт размер буфера, используемого при проксировании.
40 По умолчанию размер одного буфера равен размеру страницы.
41 В зависимости от платформы это или 4K, или 8K.
42 </para>
43
44 </directive>
45
46
47 <directive name="proxy_pass_error_message">
48 <syntax><literal>on</literal> | <literal>off</literal></syntax>
49 <default>off</default>
50 <context>mail</context>
51 <context>server</context>
52
53 <para>
54 Определяет, передавать ли клиенту сообщение об ошибке,
55 полученное при авторизации на бэкенде.
56 </para>
57
58 <para>
59 Обычно, если авторизация в nginx прошла успешно,
60 бэкенд не может вернуть ошибку, и если она всё же есть,
61 значит есть какая-то ошибка внутри системы.
62 В таких случаях сообщение бэкенда может содержать информацию,
63 которую нельзя показывать клиенту.
64 Однако для некоторых POP3-серверов ошибка в ответ на правильный пароль
65 является штатным поведением.
66 Например, CommuniGatePro извещает пользователя о
67 <link url="http://www.stalker.com/CommuniGatePro/Alerts.html#Quota">переполнении
68 ящика</link> или других событиях, периодически выдавая
69 <link url="http://www.stalker.com/CommuniGatePro/POP.html#Alerts">ошибку
70 авторизации</link>.
71 В этом случае директиву стоит включить.
72 </para>
73
74 </directive>
75
76
77 <directive name="proxy_timeout">
78 <syntax><value>время</value></syntax>
79 <default>24h</default>
80 <context>mail</context>
81 <context>server</context>
82
83 <para>
84 Задаёт таймаут, который используется после начала проксирования на бэкенд.
85 </para>
86
87 </directive>
88
89
90 <directive name="xclient">
91 <syntax><literal>on</literal> | <literal>off</literal></syntax>
92 <default>on</default>
93 <context>mail</context>
94 <context>server</context>
95
96 <para>
97 Разрешает или запрещает передачу команды <literal>XCLIENT</literal>
98 при подключении к SMTP-бэкенду.
99 Для работы команды <literal>XCLIENT</literal> необходим Postfix с
100 <link url="http://citrin.ru/nginx:xclient-login-patch">патчем</link>,
101 который добавляет параметр <literal>LOGIN</literal>.
102 Если не использовать <literal>XCLIENT</literal>, то MTA не сможет писать в лог
103 <literal>IP</literal>/<literal>HELO</literal>/<literal>LOGIN</literal>
104 клиента и применять различные ограничения на основе этих данных.
105 </para>
106
107 <para>
108 Если <literal>xclient</literal> включено,
109 то при подключении к бэкенду nginx сначала передаёт
110 <example>
111 EHLO server_name
112 </example>
113 потом
114 <example>
115 XCLIENT PROTO=ESMTP HELO=client_hello ADDR=192.168.1.1 LOGIN=good_user NAME=[UNAVAILABLE]
116 </example>
117 Если клиент при подключении к nginx передал <literal>EHLO</literal>, то в
118 команде <literal>XCLIENT</literal> передаётся <literal>PROTO=ESMTP</literal>.
119 В противном случае передаётся <literal>PROTO=SMTP</literal>.
120 В параметре <literal>ADDR</literal> указывается IP-адрес клиента,
121 а поскольку nginx не обращается к DNS для получения имени хоста,
122 то указывается <literal>NAME=[UNAVAILABLE]</literal>.
123 </para>
124
125 <para>
126 Если же <literal>xclient</literal> выключено,
127 то при подключении к бэкенду nginx передаёт
128 <literal>EHLO</literal>, если его передал клиент,
129 и <literal>HELO</literal> в остальных случаях.
130 </para>
131
132 </directive>
133
134 </section>
135
136 </module>