Mercurial > hg > nginx-site
comparison xml/ru/docs/mail/ngx_mail_proxy_module.xml @ 630:a235ce0f8eef
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> |