Mercurial > hg > nginx-site

annotate xml/ru/docs/mail/ngx_mail_core_module.xml @ 636:310872ba13ae

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Removed the "timeout=300s" directive from SMTP examples. Such an initial timeout is too long, and the default timeout of one minute is long enough. By removing it, we purposedly ignore the requirement of the current SMTP specification to set it to at least five minutes: http://tools.ietf.org/html/rfc5321#section-4.5.3.2 Submitted by Maxim Dounin.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 15 Aug 2012 11:28:37 +0000
parents 07f009b59a28
children 9a85069172dc
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 <!--
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
4 Copyright (C) Anton Yuzhaninov 2006,2007
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_core_module"
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
11 link="/ru/docs/mail/ngx_mail_core_module.html"
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
12 lang="ru"
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
13 rev="1">
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="summary">
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 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
18 По умолчанию этот модуль не собирается, его сборку необходимо
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
19 разрешить с помощью конфигурационного параметра
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
20 <literal>--with-mail</literal>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
21 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
22
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
23 </section>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
24
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 <section id="example" name="Пример конфигурации">
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 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
29 <example>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
30 worker_processes 1;
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 error_log /var/log/nginx/error.log info;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
33
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
34 mail {
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
35 server_name mail.example.com;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
36 auth_http localhost:9000/cgi-bin/nginxauth.cgi;
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 imap_capabilities IMAP4rev1 UIDPLUS IDLE LITERAL+ QUOTA;
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 pop3_auth plain apop cram-md5;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
41 pop3_capabilities LAST TOP USER PIPELINING UIDL;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
42
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
43 smtp_auth login plain cram-md5;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
44 smtp_capabilities "SIZE 10485760" ENHANCEDSTATUSCODES 8BITMIME DSN;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
45 xclient off;
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 server {
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
48 listen 25;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
49 protocol smtp;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
50 }
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
51 server {
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
52 listen 110;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
53 protocol pop3;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
54 proxy on;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
55 proxy_pass_error_message on;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
56 }
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
57 server {
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
58 listen 143;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
59 protocol imap;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
60 proxy on;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
61 }
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
62 server {
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
63 listen 587;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
64 protocol smtp;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
65 }
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 </example>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
68 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
69
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
70 </section>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
71
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 <section id="directives" name="Директивы">
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 name="imap_capabilities">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
76 <syntax><value>расширение</value> ...</syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
77 <default>IMAP4 IMAP4rev1 UIDPLUS</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
78 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
79 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
80
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
81 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
82 Позволяет указать список расширений
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
83 <link url="http://tools.ietf.org/html/rfc3501">протокола IMAP</link>,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
84 выдаваемый клиенту по команде
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
85 <literal>CAPABILITY</literal>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
86 К этому списку автоматически добавляется
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
87 <link url="http://tools.ietf.org/html/rfc2595">STARTTLS</link>,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
88 если включена директива <link doc="ngx_mail_ssl_module.xml" id="starttls"/>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
89 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
90
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
91 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
92 В данной директиве имеет смысл указать расширения,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
93 поддерживаемые IMAP-бэкендами,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
94 на которые проксируются клиенты (если эти расширения относятся к командам,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
95 используемым после авторизации, когда nginx прозрачно проксирует подключение
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
96 клиента на бэкенд).
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
97 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
98
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
99 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
100 Текущий список стандартизованных расширений опубликован на
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
101 <link url="http://www.iana.org/assignments/imap4-capabilities">www.iana.org</link>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
102 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
103
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
104 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
105
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
106
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
107 <directive name="imap_client_buffer">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
108 <syntax><value>размер</value></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
109 <default>4k|8k</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
110 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
111 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
112
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
113 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
114 Задаёт размер буфера для чтения IMAP-команд.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
115 По умолчанию размер одного буфера равен размеру страницы.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
116 В зависимости от платформы это или 4K, или 8K.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
117 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
118
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
119 </directive>
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
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
122 <directive name="listen">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
123 <syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
124 <value>адрес</value>:<value>порт</value>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
125 [<literal>bind</literal>]</syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
126 <default/>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
127 <context>server</context>
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 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
130 Задаёт <value>адрес</value> и <value>порт</value> сокета, на котором сервер
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 Можно указать только порт.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
133 Кроме того, адрес может быть именем сервера, например:
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
134 <example>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
135 listen 127.0.0.1:110;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
136 listen *:110;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
137 listen 110; # то же, что и *:110
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
138 listen localhost:110;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
139 </example>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
140 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
141
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
142 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
143 Необязательный параметр <literal>bind</literal>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
144 указывает, что для данной пары
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
145 <value>адрес</value>:<value>порт</value> нужно делать
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
146 <c-func>bind</c-func> отдельно.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
147 Дело в том, что если описаны несколько директив <literal>listen</literal>
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 <literal>listen</literal> слушает на всех адресах для данного порта
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
150 (<literal>*:</literal><value>порт</value>, то nginx сделает
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
151 <c-func>bind</c-func> только на <literal>*:</literal><value>порт</value>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
152 Необходимо заметить, что в этом случае для определения адреса, на которой
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
153 пришло соединение, делается системный вызов <c-func>getsockname</c-func>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
154 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
155
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
156 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
157 Разные виртуальные серверы должны слушать на разных парах
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
158 <value>адрес</value>:<value>порт</value>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
159 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
160
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
161 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
162
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
163
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
164 <directive name="pop3_auth">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
165 <syntax><value>метод</value> ...</syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
166 <default>plain</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
167 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
168 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
169
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
170 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
171 Задаёт разрешённые методы аутентификации POP3-клиентов.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
172 Поддерживаемые методы:
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
173 <list type="tag">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
174
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
175 <tag-name><literal>plain</literal></tag-name>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
176 <tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
177 <link url="http://tools.ietf.org/html/rfc1939">USER/PASS</link>,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
178 <link url="http://tools.ietf.org/html/rfc2595">AUTH PLAIN</link>,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
179 <link url="http://tools.ietf.org/html/draft-murchison-sasl-login-00">AUTH LOGIN</link>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
180 Данные методы отключить нельзя.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
181 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
182
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
183 <tag-name><literal>apop</literal></tag-name>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
184 <tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
185 <link url="http://tools.ietf.org/html/rfc1939">APOP</link>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
186 Для работы этого метода пароль должен храниться в незашифрованном виде.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
187 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
188
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
189 <tag-name><literal>cram-md5</literal></tag-name>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
190 <tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
191 <link url="http://tools.ietf.org/html/rfc2195">AUTH CRAM-MD5</link>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
192 Для работы этого метода пароль должен храниться в незашифрованном виде.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
193 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
194
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
195 </list>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
196 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
197
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
198 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
199
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
200
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
201 <directive name="pop3_capabilities">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
202 <syntax><value>расширение</value> ...</syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
203 <default>TOP USER UIDL</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
204 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
205 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
206
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
207 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
208 Позволяет указать список расширений
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
209 <link url="http://tools.ietf.org/html/rfc2449">протокола POP3</link>,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
210 выдаваемый клиенту по команде
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
211 <literal>CAPA</literal>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
212 К этому списку автоматически добавляются
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
213 методы авторизации, указанные в директиве <link id="pop3_auth"/>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
214 (расширение <link url="http://tools.ietf.org/html/rfc2449">SASL</link>) и
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
215 <link url="http://tools.ietf.org/html/rfc2595">STLS</link>,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
216 если включена директива <link doc="ngx_mail_ssl_module.xml" id="starttls"/>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
217 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
218
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
219 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
220 В данной директиве имеет смысл указать расширения,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
221 поддерживаемые POP3-бэкендами,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
222 на которые проксируются клиенты (если эти расширения относятся к командам,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
223 используемым после авторизации, когда nginx прозрачно проксирует подключение
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
224 клиента на бэкенд).
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
225 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
226
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
227 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
228 Текущий список стандартизованных расширений опубликован на
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
229 <link url="http://www.iana.org/assignments/pop3-extension-mechanism">www.iana.org</link>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
230 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
231
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
232 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
233
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
234
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
235 <directive name="protocol">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
236 <syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
237 <literal>imap</literal> |
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
238 <literal>pop3</literal> |
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
239 <literal>smtp</literal></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
240 <default/>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
241 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
242
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
243 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
244 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
245
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
246 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
247
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
248
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
249 <directive name="server">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
250 <syntax block="yes"/>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
251 <default/>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
252 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
253
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
254 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
255 Задаёт конфигурацию для виртуального сервера.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
256 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
257
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
258 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
259
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
260
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
261 <directive name="server_name">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
262 <syntax><value>имя</value></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
263 <default>имя хоста</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
264 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
265 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
266
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
267 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
268 Задаёт имя сервера, используемое:
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
269
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
270 <list type="bullet">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
271
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
272 <listitem>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
273 в начальном приветствии POP3/SMTP-сервера;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
274 </listitem>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
275
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
276 <listitem>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
277 в salt при авторизации SASL-методом CRAM-MD5;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
278 </listitem>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
279
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
280 <listitem>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
281 в команде <literal>EHLO</literal> при подключении к SMTP-бэкенду,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
282 если включена команда <link doc="ngx_mail_proxy_module.xml" id="xclient"/>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
283 </listitem>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
284
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
285 </list>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
286
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
287 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
288
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
289 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
290
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
291
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
292 <directive name="smtp_auth">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
293 <syntax><value>метод</value> ...</syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
294 <default>login plain</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
295 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
296 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
297
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
298 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
299 Задаёт разрешённые методы
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
300 <link url="http://tools.ietf.org/html/rfc2554">SASL-аутентификации</link>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
301 SMTP-клиентов.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
302 Поддерживаемые методы:
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
303 <list type="tag">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
304
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
305 <tag-name><literal>login</literal></tag-name>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
306 <tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
307 <link url="http://tools.ietf.org/html/draft-murchison-sasl-login-00">AUTH LOGIN</link>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
308 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
309
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
310 <tag-name><literal>plain</literal></tag-name>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
311 <tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
312 <link url="http://tools.ietf.org/html/rfc2595">AUTH PLAIN</link>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
313 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
314
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
315 <tag-name><literal>cram-md5</literal></tag-name>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
316 <tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
317 <link url="http://tools.ietf.org/html/rfc2195">AUTH CRAM-MD5</link>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
318 Для работы этого метода пароль должен храниться в незашифрованном виде.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
319 </tag-desc>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
320
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
321 </list>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
322 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
323
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
324 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
325
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
326
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
327 <directive name="smtp_capabilities">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
328 <syntax><value>расширение</value> ...</syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
329 <default/>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
330 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
331 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
332
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
333 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
334 Позволяет указать список расширений протокола SMTP,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
335 выдаваемый клиенту в ответе на команду
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
336 <literal>EHLO</literal>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
337 К этому списку автоматически добавляются
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
338 методы авторизации, указанные в директиве <link id="smtp_auth"/>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
339 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
340
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
341 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
342 В данной директиве имеет смысл указать расширения,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
343 поддерживаемые MTA,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
344 на который проксируются клиенты (если эти расширения относятся к командам,
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
345 используемым после авторизации, когда nginx прозрачно проксирует подключение
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
346 клиента на бэкенд).
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
347 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
348
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
349 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
350 Текущий список стандартизованных расширений опубликован на
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
351 <link url="http://www.iana.org/assignments/mail-parameters">www.iana.org</link>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
352 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
353
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
354 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
355
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
356
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
357 <directive name="so_keepalive">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
358 <syntax><literal>on</literal> | <literal>off</literal></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
359 <default>off</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
360 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
361 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
362
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
363 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
364 При подключении к IMAP/POP3-бэкенду определяет для сокета поведение
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
365 “TCP keepalive”.
635
07f009b59a28 Corrected the description of "so_keepalive off".
Ruslan Ermilov <ru@nginx.com>
parents: 630
diff changeset
366 Если директива не указана или выключена, то для сокета будут действовать
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
367 настройки операционной системы.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
368 Если включено, то для сокета
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
369 включается параметр <c-def>SO_KEEPALIVE</c-def>.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
370 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
371
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
372 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
373
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
374
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
375 <directive name="timeout">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
376 <syntax><value>время</value></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
377 <default>60s</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
378 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
379 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
380
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
381 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
382 Задаёт таймаут, который используется до начала проксирования на бэкенд.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
383 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
384
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
385 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
386
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
387 </section>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
388
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
389 </module>