Mercurial > hg > nginx-site

annotate xml/ru/docs/mail/ngx_mail_core_module.xml @ 2722:1261698ec228

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the max_errors directive for mail.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 17 May 2021 12:30:21 +0100
parents 5f961aa083db
children 00afc7c4d4df
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: 637
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_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"
2722
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
13 rev="18">
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="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>
2690
4d073d1b0b79 Updated worker_processes value in Example configuration for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2676
diff changeset
30 worker_processes auto;
630
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
1528
3ae5301ea37a Added the "events" section to examples of stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1502
diff changeset
34 events {
3ae5301ea37a Added the "events" section to examples of stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1502
diff changeset
35 worker_connections 1024;
3ae5301ea37a Added the "events" section to examples of stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1502
diff changeset
36 }
3ae5301ea37a Added the "events" section to examples of stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1502
diff changeset
37
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
38 mail {
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
39 server_name mail.example.com;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
40 auth_http localhost:9000/cgi-bin/nginxauth.cgi;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
41
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
42 imap_capabilities IMAP4rev1 UIDPLUS IDLE LITERAL+ QUOTA;
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 pop3_auth plain apop cram-md5;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
45 pop3_capabilities LAST TOP USER PIPELINING UIDL;
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 smtp_auth login plain cram-md5;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
48 smtp_capabilities "SIZE 10485760" ENHANCEDSTATUSCODES 8BITMIME DSN;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
49 xclient off;
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 25;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
53 protocol smtp;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
54 }
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
55 server {
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
56 listen 110;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
57 protocol pop3;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
58 proxy_pass_error_message on;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
59 }
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
60 server {
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
61 listen 143;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
62 protocol imap;
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 server {
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
65 listen 587;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
66 protocol smtp;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
67 }
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
68 }
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
69 </example>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
70 </para>
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 </section>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
73
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 <section id="directives" name="Директивы">
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 <directive name="listen">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
78 <syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
79 <value>адрес</value>:<value>порт</value>
1488
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
80 [<literal>ssl</literal>]
2676
468e6e14e5cc Documented the PROXY protocol support in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2471
diff changeset
81 [<literal>proxy_protocol</literal>]
1502
b628e042a15e Documented "listen backlog=" in mail and stream.
Ruslan Ermilov <ru@nginx.com>
parents: 1489
diff changeset
82 [<literal>backlog</literal>=<value>число</value>]
1963
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
83 [<literal>rcvbuf</literal>=<value>размер</value>]
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
84 [<literal>sndbuf</literal>=<value>размер</value>]
1488
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
85 [<literal>bind</literal>]
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
86 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
87 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
88 <default/>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
89 <context>server</context>
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 Задаёт <value>адрес</value> и <value>порт</value> сокета, на котором сервер
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
93 будет принимать запросы.
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 Кроме того, адрес может быть именем сервера, например:
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
96 <example>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
97 listen 127.0.0.1:110;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
98 listen *:110;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
99 listen 110; # то же, что и *:110
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
100 listen localhost:110;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
101 </example>
644
b4d15f1c7c06 Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents: 643
diff changeset
102 IPv6-адреса (0.7.58) задаются в квадратных скобках:
b4d15f1c7c06 Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents: 643
diff changeset
103 <example>
b4d15f1c7c06 Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents: 643
diff changeset
104 listen [::1]:110;
b4d15f1c7c06 Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents: 643
diff changeset
105 listen [::]:110;
b4d15f1c7c06 Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents: 643
diff changeset
106 </example>
b4d15f1c7c06 Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents: 643
diff changeset
107 UNIX-сокеты (1.3.5) задаются при помощи префикса “<literal>unix:</literal>”:
b4d15f1c7c06 Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents: 643
diff changeset
108 <example>
b4d15f1c7c06 Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents: 643
diff changeset
109 listen unix:/var/run/nginx.sock;
b4d15f1c7c06 Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents: 643
diff changeset
110 </example>
b4d15f1c7c06 Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents: 643
diff changeset
111
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
112 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
113
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
114 <para>
1489
9f9b8543b946 Relocated phrase in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1488
diff changeset
115 Разные серверы должны слушать на разных парах
9f9b8543b946 Relocated phrase in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1488
diff changeset
116 <value>адрес</value>:<value>порт</value>.
9f9b8543b946 Relocated phrase in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1488
diff changeset
117 </para>
9f9b8543b946 Relocated phrase in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1488
diff changeset
118
9f9b8543b946 Relocated phrase in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1488
diff changeset
119 <para>
1488
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
120 Параметр <literal>ssl</literal> указывает на то, что все соединения,
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
121 принимаемые на данном порту, должны работать в режиме SSL.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
122 </para>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
123
2676
468e6e14e5cc Documented the PROXY protocol support in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2471
diff changeset
124 <para id="proxy_protocol">
468e6e14e5cc Documented the PROXY protocol support in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2471
diff changeset
125 Параметр <literal>proxy_protocol</literal> (1.19.8)
468e6e14e5cc Documented the PROXY protocol support in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2471
diff changeset
126 указывает на то, что все соединения, принимаемые на данном порту,
468e6e14e5cc Documented the PROXY protocol support in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2471
diff changeset
127 должны использовать
468e6e14e5cc Documented the PROXY protocol support in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2471
diff changeset
128 <link url="http://www.haproxy.org/download/1.5/doc/proxy-protocol.txt">протокол
468e6e14e5cc Documented the PROXY protocol support in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2471
diff changeset
129 PROXY</link>.
468e6e14e5cc Documented the PROXY protocol support in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2471
diff changeset
130 Полученная информация передаётся
2691
5f961aa083db Mentioned realip module in the listen directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2690
diff changeset
131 <link doc="ngx_mail_auth_http_module.xml" id="proxy_protocol">серверу аутентификации</link>
5f961aa083db Mentioned realip module in the listen directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2690
diff changeset
132 и может быть использована для
5f961aa083db Mentioned realip module in the listen directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2690
diff changeset
133 <link doc="ngx_mail_realip_module.xml">изменения адреса клиента</link>.
2676
468e6e14e5cc Documented the PROXY protocol support in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2471
diff changeset
134 </para>
468e6e14e5cc Documented the PROXY protocol support in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2471
diff changeset
135
1488
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
136 <para>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
137 В директиве <literal>listen</literal> можно также указать несколько
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
138 дополнительных параметров, специфичных для связанных с сокетами
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
139 системных вызовов.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
140 <list type="tag">
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
141
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
142 <tag-name>
1502
b628e042a15e Documented "listen backlog=" in mail and stream.
Ruslan Ermilov <ru@nginx.com>
parents: 1489
diff changeset
143 <literal>backlog</literal>=<value>число</value>
b628e042a15e Documented "listen backlog=" in mail and stream.
Ruslan Ermilov <ru@nginx.com>
parents: 1489
diff changeset
144 </tag-name>
b628e042a15e Documented "listen backlog=" in mail and stream.
Ruslan Ermilov <ru@nginx.com>
parents: 1489
diff changeset
145 <tag-desc>
b628e042a15e Documented "listen backlog=" in mail and stream.
Ruslan Ermilov <ru@nginx.com>
parents: 1489
diff changeset
146 задаёт параметр <literal>backlog</literal> в вызове
b628e042a15e Documented "listen backlog=" in mail and stream.
Ruslan Ermilov <ru@nginx.com>
parents: 1489
diff changeset
147 <c-func>listen</c-func>, который ограничивает
b628e042a15e Documented "listen backlog=" in mail and stream.
Ruslan Ermilov <ru@nginx.com>
parents: 1489
diff changeset
148 максимальный размер очереди ожидающих приёма соединений (1.9.2).
b628e042a15e Documented "listen backlog=" in mail and stream.
Ruslan Ermilov <ru@nginx.com>
parents: 1489
diff changeset
149 По умолчанию <literal>backlog</literal> устанавливается равным -1 для
1911
f024ac0ec5c7 Apple rebranded Mac OS X to macOS.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1528
diff changeset
150 FreeBSD, DragonFly BSD и macOS, и 511 для других платформ.
1502
b628e042a15e Documented "listen backlog=" in mail and stream.
Ruslan Ermilov <ru@nginx.com>
parents: 1489
diff changeset
151 </tag-desc>
b628e042a15e Documented "listen backlog=" in mail and stream.
Ruslan Ermilov <ru@nginx.com>
parents: 1489
diff changeset
152
b628e042a15e Documented "listen backlog=" in mail and stream.
Ruslan Ermilov <ru@nginx.com>
parents: 1489
diff changeset
153 <tag-name>
1963
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
154 <literal>rcvbuf</literal>=<value>размер</value>
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
155 </tag-name>
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
156 <tag-desc>
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
157 задаёт размер буфера приёма
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
158 (параметр <c-def>SO_RCVBUF</c-def>) для слушающего сокета (1.11.13).
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
159 </tag-desc>
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
160
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
161 <tag-name>
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
162 <literal>sndbuf</literal>=<value>размер</value>
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
163 </tag-name>
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
164 <tag-desc>
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
165 задаёт размер буфера передачи
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
166 (параметр <c-def>SO_SNDBUF</c-def>) для слушающего сокета (1.11.13).
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
167 </tag-desc>
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
168
351cefd5ff9c Documented rcvbuf and sndbuf for mail and stream listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1911
diff changeset
169 <tag-name>
1488
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
170 <literal>bind</literal>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
171 </tag-name>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
172 <tag-desc>
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
173 указывает, что для данной пары
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
174 <value>адрес</value>:<value>порт</value> нужно делать
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
175 <c-func>bind</c-func> отдельно.
1488
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
176 Это нужно потому, что если описаны несколько директив <literal>listen</literal>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 924
diff changeset
177 с одинаковым портом, но разными адресами, и одна из директив
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
178 <literal>listen</literal> слушает на всех адресах для данного порта
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 924
diff changeset
179 (<literal>*:</literal><value>порт</value>), то nginx сделает
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
180 <c-func>bind</c-func> только на <literal>*:</literal><value>порт</value>.
1046
b81ad8234f90 Minor assorted fixes.
Sergey Kandaurov <pluknet@nginx.com>
parents: 966
diff changeset
181 Необходимо заметить, что в этом случае для определения адреса, на который
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
182 пришло соединение, делается системный вызов <c-func>getsockname</c-func>.
1488
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
183 Если же используются параметры <literal>ipv6only</literal>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
184 или <literal>so_keepalive</literal>,
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
185 то для данной пары
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
186 <value>адрес</value>:<value>порт</value> всегда делается
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
187 отдельный вызов <c-func>bind</c-func>.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
188 </tag-desc>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
189
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
190 <tag-name>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
191 <literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
192 </tag-name>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
193 <tag-desc>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
194 этот параметр определяет
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
195 (через параметр сокета <c-def>IPV6_V6ONLY</c-def>),
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
196 будет ли слушающий на wildcard-адресе <literal>[::]</literal> IPv6-сокет
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
197 принимать только IPv6-соединения, или же одновременно IPv6- и IPv4-соединения.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
198 По умолчанию параметр включён.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
199 Установить его можно только один раз на старте.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
200 </tag-desc>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
201
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
202 <tag-name>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
203 <literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
204 </tag-name>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
205 <tag-desc>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
206 этот параметр конфигурирует для слушающего сокета
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
207 поведение “TCP keepalive”.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
208 Если этот параметр опущен, то для сокета будут действовать
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
209 настройки операционной системы.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
210 Если он установлен в значение “<literal>on</literal>”, то для сокета
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
211 включается параметр <c-def>SO_KEEPALIVE</c-def>.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
212 Если он установлен в значение “<literal>off</literal>”, то для сокета
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
213 параметр <c-def>SO_KEEPALIVE</c-def> выключается.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
214 Некоторые операционные системы поддерживают настройку параметров
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
215 “TCP keepalive” на уровне сокета посредством параметров
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
216 <c-def>TCP_KEEPIDLE</c-def>, <c-def>TCP_KEEPINTVL</c-def> и
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
217 <c-def>TCP_KEEPCNT</c-def>.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
218 На таких системах (в настоящий момент это Linux 2.4+, NetBSD 5+ и
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
219 FreeBSD 9.0-STABLE)
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
220 их можно сконфигурировать с помощью параметров <value>keepidle</value>,
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
221 <value>keepintvl</value> и <value>keepcnt</value>.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
222 Один или два параметра могут быть опущены, в таком случае для
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
223 соответствующего параметра сокета будут действовать стандартные
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
224 системные настройки.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
225 Например,
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
226 <example>so_keepalive=30m::10</example>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
227 установит таймаут бездействия (<c-def>TCP_KEEPIDLE</c-def>) в 30 минут,
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
228 для интервала проб (<c-def>TCP_KEEPINTVL</c-def>) будет действовать
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
229 стандартная системная настройка, а счётчик проб (<c-def>TCP_KEEPCNT</c-def>)
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
230 будет равен 10.
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
231 </tag-desc>
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
232
0a1c5a087556 Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1471
diff changeset
233 </list>
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
234 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
235
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
236 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
237
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
238
748
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
239 <directive name="mail">
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
240 <syntax block="yes"/>
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
241 <default/>
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
242 <context>main</context>
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
243
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
244 <para>
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
245 Предоставляет контекст конфигурационного файла, в котором указываются
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
246 директивы почтового сервера.
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
247 </para>
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
248
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
249 </directive>
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
250
95344046d2d8 Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents: 644
diff changeset
251
2722
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
252 <directive name="max_errors">
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
253 <syntax><value>число</value></syntax>
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
254 <default>5</default>
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
255 <context>mail</context>
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
256 <context>server</context>
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
257 <appeared-in>1.21.0</appeared-in>
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
258
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
259 <para>
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
260 Задаёт число ошибок протокола, по достижении которого соединение закрывается.
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
261 </para>
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
262
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
263 </directive>
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
264
1261698ec228 Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2691
diff changeset
265
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
266 <directive name="protocol">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
267 <syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
268 <literal>imap</literal> |
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
269 <literal>pop3</literal> |
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
270 <literal>smtp</literal></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
271 <default/>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
272 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
273
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
274 <para>
637
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents: 636
diff changeset
275 Задаёт протокол проксируемого сервера.
643
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
276 Поддерживаются протоколы
637
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents: 636
diff changeset
277 <link doc="ngx_mail_imap_module.xml">IMAP</link>,
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents: 636
diff changeset
278 <link doc="ngx_mail_pop3_module.xml">POP3</link> и
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents: 636
diff changeset
279 <link doc="ngx_mail_smtp_module.xml">SMTP</link>.
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
280 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
281
643
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
282 <para>
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
283 Если директива не указана, то протокол может быть определён автоматически
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
284 по общеизвестному порту, указанному в директиве <link id="listen"/>:
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
285 <list type="bullet">
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
286
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
287 <listitem>
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
288 <literal>imap</literal>: 143, 993
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
289 </listitem>
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
290
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
291 <listitem>
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
292 <literal>pop3</literal>: 110, 995
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
293 </listitem>
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
294
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
295 <listitem>
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
296 <literal>smtp</literal>: 25, 587, 465
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
297 </listitem>
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
298
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
299 </list>
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
300 </para>
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
301
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
302 <para>
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
303 Поддержку ненужных протоколов можно отключить с помощью
924
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 751
diff changeset
304 <link doc="../configure.xml">конфигурационных</link>
643
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
305 параметров <literal>--without-mail_imap_module</literal>,
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
306 <literal>--without-mail_pop3_module</literal> и
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
307 <literal>--without-mail_smtp_module</literal>.
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
308 </para>
b2159031ff19 Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents: 642
diff changeset
309
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
310 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
311
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
312
1068
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
313 <directive name="resolver">
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
314 <syntax>
2451
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
315 <value>адрес</value> ...
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
316 [<literal>valid</literal>=<value>time</value>]
2453
1b0cc44de0fd Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2452
diff changeset
317 [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]
2451
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
318 [<literal>status_zone</literal>=<value>зона</value>]</syntax>
1068
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
319 <syntax><literal>off</literal></syntax>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
320 <default>off</default>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
321 <context>mail</context>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
322 <context>server</context>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
323
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
324 <para>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
325 Задаёт серверы DNS, используемые для определения имени хоста клиента
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
326 для передачи его на
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
327 <link doc="ngx_mail_auth_http_module.xml">сервер аутентификации</link>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
328 и в команде
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
329 <link doc="ngx_mail_proxy_module.xml" id="xclient">XCLIENT</link>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
330 при проксировании SMTP.
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
331 Например:
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
332 <example>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
333 resolver 127.0.0.1 [::1]:5353;
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
334 </example>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
335 Адрес может быть указан в виде доменного имени или IP-адреса,
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
336 и необязательного порта (1.3.1, 1.2.2).
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
337 Если порт не указан, используется порт 53.
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
338 Серверы DNS опрашиваются циклически.
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
339 <note>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
340 До версии 1.1.7 можно было задать лишь один DNS-сервер.
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
341 Задание DNS-серверов с помощью IPv6-адресов поддерживается
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
342 начиная с версий 1.3.1 и 1.2.2.
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
343 </note>
2452
4487310de7e7 Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2451
diff changeset
344 </para>
4487310de7e7 Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2451
diff changeset
345
2453
1b0cc44de0fd Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2452
diff changeset
346 <para id="resolver_ipv6">
1b0cc44de0fd Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2452
diff changeset
347 По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса
1b0cc44de0fd Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2452
diff changeset
348 при преобразовании имён в адреса.
1b0cc44de0fd Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2452
diff changeset
349 Если поиск IPv6-адресов нежелателен,
1b0cc44de0fd Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2452
diff changeset
350 можно указать параметр <literal>ipv6=off</literal>.
1b0cc44de0fd Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2452
diff changeset
351 <note>
1b0cc44de0fd Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2452
diff changeset
352 Преобразование имён в IPv6-адреса поддерживается
1b0cc44de0fd Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2452
diff changeset
353 начиная с версии 1.5.8.
1b0cc44de0fd Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2452
diff changeset
354 </note>
1b0cc44de0fd Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2452
diff changeset
355 </para>
1b0cc44de0fd Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2452
diff changeset
356
2452
4487310de7e7 Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2451
diff changeset
357 <para id="resolver_valid">
1068
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
358 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
359 Необязательный параметр <literal>valid</literal> позволяет это
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
360 переопределить:
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
361 <example>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
362 resolver 127.0.0.1 [::1]:5353 valid=30s;
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
363 </example>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
364 <note>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
365 До версии 1.1.9 настройка времени кэширования была невозможна
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
366 и nginx всегда кэшировал ответы на срок в 5 минут.
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
367 </note>
2471
c8f0f30e1513 Added a note about DNS spoofing to all "resolver" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 2453
diff changeset
368 <note>
c8f0f30e1513 Added a note about DNS spoofing to all "resolver" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 2453
diff changeset
369 Для предотвращения DNS-спуфинга рекомендуется
c8f0f30e1513 Added a note about DNS spoofing to all "resolver" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 2453
diff changeset
370 использовать DNS-серверы в защищённой доверенной локальной сети.
c8f0f30e1513 Added a note about DNS spoofing to all "resolver" directives.
Ruslan Ermilov <ru@nginx.com>
parents: 2453
diff changeset
371 </note>
1068
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
372 </para>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
373
2451
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
374 <para id="resolver_status_zone">
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
375 Необязательный параметр <literal>status_zone</literal> (1.17.1)
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
376 включает
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
377 <link doc="../http/ngx_http_api_module.xml" id="resolvers_">сбор информации</link>
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
378 о запросах и ответах сервера DNS
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
379 в указанной <value>зоне</value>.
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
380 Параметр доступен как часть
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
381 <commercial_version>коммерческой подписки</commercial_version>.
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
382 </para>
721f78cff4ef Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1963
diff changeset
383
2452
4487310de7e7 Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2451
diff changeset
384 <para id="resolver_off">
1068
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
385 Специальное значение <literal>off</literal> запрещает использование DNS.
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
386 </para>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
387
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
388 </directive>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
389
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
390
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
391 <directive name="resolver_timeout">
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
392 <syntax><value>время</value></syntax>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
393 <default>30s</default>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
394 <context>mail</context>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
395 <context>server</context>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
396
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
397 <para>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
398 Задаёт таймаут для операций DNS, например:
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
399 <example>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
400 resolver_timeout 5s;
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
401 </example>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
402 </para>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
403
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
404 </directive>
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
405
0c5f8630fe40 Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1067
diff changeset
406
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
407 <directive name="server">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
408 <syntax block="yes"/>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
409 <default/>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
410 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
411
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
412 <para>
751
9c1ffd02f1b7 Removed "virtual" and HTTPS references from mail modules.
Vladimir Homutov <vl@nginx.com>
parents: 748
diff changeset
413 Задаёт конфигурацию для сервера.
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
414 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
415
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
416 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
417
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
418
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
419 <directive name="server_name">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
420 <syntax><value>имя</value></syntax>
1067
8d9578f8523b The use of the canonical "hostname" term in Russian translation.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1046
diff changeset
421 <default>hostname</default>
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
422 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
423 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
424
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
425 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
426 Задаёт имя сервера, используемое:
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
427 <list type="bullet">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
428
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
429 <listitem>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
430 в начальном приветствии POP3/SMTP-сервера;
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
431 </listitem>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
432
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
433 <listitem>
641
Ruslan Ermilov <ru@nginx.com>
parents: 639
diff changeset
434 в salt при аутентификации SASL-методом CRAM-MD5;
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
435 </listitem>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
436
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
437 <listitem>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
438 в команде <literal>EHLO</literal> при подключении к SMTP-бэкенду,
1070
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1069
diff changeset
439 если разрешена передача команды
73b31b44d3a0 Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1069
diff changeset
440 <link doc="ngx_mail_proxy_module.xml" id="xclient">XCLIENT</link>.
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
441 </listitem>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
442
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
443 </list>
1069
71e6daffa4dc Documented behavior in the absence of the "server_name" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1068
diff changeset
444 </para>
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
445
1069
71e6daffa4dc Documented behavior in the absence of the "server_name" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1068
diff changeset
446 <para>
71e6daffa4dc Documented behavior in the absence of the "server_name" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1068
diff changeset
447 Если директива не указана, используется имя хоста (hostname) машины.
630
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
448 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
449
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
450 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
451
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
452
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
453 <directive name="timeout">
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
454 <syntax><value>время</value></syntax>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
455 <default>60s</default>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
456 <context>mail</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
457 <context>server</context>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
458
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
459 <para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
460 Задаёт таймаут, который используется до начала проксирования на бэкенд.
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
461 </para>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
462
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
463 </directive>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
464
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
465 </section>
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
466
a235ce0f8eef Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
467 </module>