Mercurial > hg > nginx-site
annotate xml/ru/docs/mail/ngx_mail_core_module.xml @ 3004:c95cbff9f571
Added info about the Unit 1.31.0 release.
author | Artem Konev <artem.konev@nginx.com> |
---|---|
date | Thu, 31 Aug 2023 22:38:02 +0100 |
parents | 7ebe15d6c68d |
children | 9eadb98ec770 |
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 | 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" |
2912
7ebe15d6c68d
Updated link to the PROXY protocol specification.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2870
diff
changeset
|
13 rev="21"> |
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 должны использовать |
2912
7ebe15d6c68d
Updated link to the PROXY protocol specification.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2870
diff
changeset
|
128 <link url="http://www.haproxy.org/download/1.8/doc/proxy-protocol.txt">протокол |
2676
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 | 177 с одинаковым портом, но разными адресами, и одна из директив |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
178 <literal>listen</literal> слушает на всех адресах для данного порта |
966 | 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 | 181 Необходимо заметить, что в этом случае для определения адреса, на который |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
182 пришло соединение, делается системный вызов <c-func>getsockname</c-func>. |
2724
00afc7c4d4df
Documented listen options that imply "bind".
Ruslan Ermilov <ru@nginx.com>
parents:
2722
diff
changeset
|
183 Если же используются параметры <literal>backlog</literal>, |
00afc7c4d4df
Documented listen options that imply "bind".
Ruslan Ermilov <ru@nginx.com>
parents:
2722
diff
changeset
|
184 <literal>rcvbuf</literal>, <literal>sndbuf</literal>, |
00afc7c4d4df
Documented listen options that imply "bind".
Ruslan Ermilov <ru@nginx.com>
parents:
2722
diff
changeset
|
185 <literal>ipv6only</literal> |
1488
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
186 или <literal>so_keepalive</literal>, |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
187 то для данной пары |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
188 <value>адрес</value>:<value>порт</value> всегда делается |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
189 отдельный вызов <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
|
190 </tag-desc> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
191 |
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 <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
|
194 </tag-name> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
195 <tag-desc> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
196 этот параметр определяет |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
197 (через параметр сокета <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
|
198 будет ли слушающий на wildcard-адресе <literal>[::]</literal> IPv6-сокет |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
199 принимать только IPv6-соединения, или же одновременно IPv6- и IPv4-соединения. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
200 По умолчанию параметр включён. |
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-desc> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
203 |
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 <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
|
206 </tag-name> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
207 <tag-desc> |
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 поведение “TCP keepalive”. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
210 Если этот параметр опущен, то для сокета будут действовать |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
211 настройки операционной системы. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
212 Если он установлен в значение “<literal>on</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 Если он установлен в значение “<literal>off</literal>”, то для сокета |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
215 параметр <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
|
216 Некоторые операционные системы поддерживают настройку параметров |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
217 “TCP keepalive” на уровне сокета посредством параметров |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
218 <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
|
219 <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
|
220 На таких системах (в настоящий момент это 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
|
221 FreeBSD 9.0-STABLE) |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
222 их можно сконфигурировать с помощью параметров <value>keepidle</value>, |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
223 <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
|
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 системные настройки. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
227 Например, |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
228 <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
|
229 установит таймаут бездействия (<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
|
230 для интервала проб (<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
|
231 стандартная системная настройка, а счётчик проб (<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
|
232 будет равен 10. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
233 </tag-desc> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
234 |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
235 </list> |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
236 </para> |
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 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
239 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
240 |
748
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
241 <directive name="mail"> |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
242 <syntax block="yes"/> |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
243 <default/> |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
244 <context>main</context> |
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 <para> |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
247 Предоставляет контекст конфигурационного файла, в котором указываются |
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 </para> |
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 </directive> |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
252 |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
253 |
2722
1261698ec228
Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2691
diff
changeset
|
254 <directive name="max_errors"> |
1261698ec228
Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2691
diff
changeset
|
255 <syntax><value>число</value></syntax> |
1261698ec228
Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2691
diff
changeset
|
256 <default>5</default> |
1261698ec228
Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2691
diff
changeset
|
257 <context>mail</context> |
1261698ec228
Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2691
diff
changeset
|
258 <context>server</context> |
1261698ec228
Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2691
diff
changeset
|
259 <appeared-in>1.21.0</appeared-in> |
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 </para> |
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 </directive> |
1261698ec228
Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2691
diff
changeset
|
266 |
1261698ec228
Documented the max_errors directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2691
diff
changeset
|
267 |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
268 <directive name="protocol"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
269 <syntax> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
270 <literal>imap</literal> | |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
271 <literal>pop3</literal> | |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
272 <literal>smtp</literal></syntax> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
273 <default/> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
274 <context>server</context> |
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 <para> |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
636
diff
changeset
|
277 Задаёт протокол проксируемого сервера. |
643
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
278 Поддерживаются протоколы |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
636
diff
changeset
|
279 <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
|
280 <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
|
281 <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
|
282 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
283 |
643
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
284 <para> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
285 Если директива не указана, то протокол может быть определён автоматически |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
286 по общеизвестному порту, указанному в директиве <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
|
287 <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
|
288 |
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 <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
|
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 |
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 <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
|
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 |
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 <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
|
299 </listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
300 |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
301 </list> |
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 |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
304 <para> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
305 Поддержку ненужных протоколов можно отключить с помощью |
924 | 306 <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
|
307 параметров <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
|
308 <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
|
309 <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
|
310 </para> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
311 |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
312 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
313 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
314 |
1068
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
315 <directive name="resolver"> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
316 <syntax> |
2451
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
317 <value>адрес</value> ... |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
318 [<literal>valid</literal>=<value>time</value>] |
2870
e06cf66a9f63
Documented the "ipv4=off" parameter of the "resolver" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2724
diff
changeset
|
319 [<literal>ipv4</literal>=<literal>on</literal>|<literal>off</literal>] |
2453
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
320 [<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
|
321 [<literal>status_zone</literal>=<value>зона</value>]</syntax> |
1068
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
322 <syntax><literal>off</literal></syntax> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
323 <default>off</default> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
324 <context>mail</context> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
325 <context>server</context> |
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 <para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
328 Задаёт серверы DNS, используемые для определения имени хоста клиента |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
329 для передачи его на |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
330 <link doc="ngx_mail_auth_http_module.xml">сервер аутентификации</link> |
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 <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
|
333 при проксировании SMTP. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
334 Например: |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
335 <example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
336 resolver 127.0.0.1 [::1]:5353; |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
337 </example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
338 Адрес может быть указан в виде доменного имени или IP-адреса, |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
339 и необязательного порта (1.3.1, 1.2.2). |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
340 Если порт не указан, используется порт 53. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
341 Серверы DNS опрашиваются циклически. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
342 <note> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
343 До версии 1.1.7 можно было задать лишь один DNS-сервер. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
344 Задание DNS-серверов с помощью IPv6-адресов поддерживается |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
345 начиная с версий 1.3.1 и 1.2.2. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
346 </note> |
2452
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2451
diff
changeset
|
347 </para> |
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2451
diff
changeset
|
348 |
2453
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
349 <para id="resolver_ipv6"> |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
350 По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
351 при преобразовании имён в адреса. |
2870
e06cf66a9f63
Documented the "ipv4=off" parameter of the "resolver" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2724
diff
changeset
|
352 Если поиск IPv4- или IPv6-адресов нежелателен, |
e06cf66a9f63
Documented the "ipv4=off" parameter of the "resolver" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2724
diff
changeset
|
353 можно указать параметр <literal>ipv4=off</literal> (1.23.1) или |
e06cf66a9f63
Documented the "ipv4=off" parameter of the "resolver" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2724
diff
changeset
|
354 <literal>ipv6=off</literal>. |
2453
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
355 <note> |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
356 Преобразование имён в IPv6-адреса поддерживается |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
357 начиная с версии 1.5.8. |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
358 </note> |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
359 </para> |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
360 |
2452
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2451
diff
changeset
|
361 <para id="resolver_valid"> |
1068
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
362 По умолчанию nginx кэширует ответы, используя значение TTL из ответа. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
363 Необязательный параметр <literal>valid</literal> позволяет это |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
364 переопределить: |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
365 <example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
366 resolver 127.0.0.1 [::1]:5353 valid=30s; |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
367 </example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
368 <note> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
369 До версии 1.1.9 настройка времени кэширования была невозможна |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
370 и nginx всегда кэшировал ответы на срок в 5 минут. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
371 </note> |
2471
c8f0f30e1513
Added a note about DNS spoofing to all "resolver" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
2453
diff
changeset
|
372 <note> |
c8f0f30e1513
Added a note about DNS spoofing to all "resolver" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
2453
diff
changeset
|
373 Для предотвращения DNS-спуфинга рекомендуется |
c8f0f30e1513
Added a note about DNS spoofing to all "resolver" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
2453
diff
changeset
|
374 использовать DNS-серверы в защищённой доверенной локальной сети. |
c8f0f30e1513
Added a note about DNS spoofing to all "resolver" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
2453
diff
changeset
|
375 </note> |
1068
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
376 </para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
377 |
2451
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
378 <para id="resolver_status_zone"> |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
379 Необязательный параметр <literal>status_zone</literal> (1.17.1) |
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 <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
|
382 о запросах и ответах сервера DNS |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
383 в указанной <value>зоне</value>. |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
384 Параметр доступен как часть |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
385 <commercial_version>коммерческой подписки</commercial_version>. |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
386 </para> |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
387 |
2452
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2451
diff
changeset
|
388 <para id="resolver_off"> |
1068
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
389 Специальное значение <literal>off</literal> запрещает использование DNS. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
390 </para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
391 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
392 </directive> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
393 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
394 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
395 <directive name="resolver_timeout"> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
396 <syntax><value>время</value></syntax> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
397 <default>30s</default> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
398 <context>mail</context> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
399 <context>server</context> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
400 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
401 <para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
402 Задаёт таймаут для операций DNS, например: |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
403 <example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
404 resolver_timeout 5s; |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
405 </example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
406 </para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
407 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
408 </directive> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
409 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
410 |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
411 <directive name="server"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
412 <syntax block="yes"/> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
413 <default/> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
414 <context>mail</context> |
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 <para> |
751
9c1ffd02f1b7
Removed "virtual" and HTTPS references from mail modules.
Vladimir Homutov <vl@nginx.com>
parents:
748
diff
changeset
|
417 Задаёт конфигурацию для сервера. |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
418 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
419 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
420 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
421 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
422 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
423 <directive name="server_name"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
424 <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
|
425 <default>hostname</default> |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
426 <context>mail</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
427 <context>server</context> |
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 <para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
430 Задаёт имя сервера, используемое: |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
431 <list type="bullet"> |
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> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
434 в начальном приветствии POP3/SMTP-сервера; |
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> |
641 | 438 в salt при аутентификации SASL-методом CRAM-MD5; |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
439 </listitem> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
440 |
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 в команде <literal>EHLO</literal> при подключении к SMTP-бэкенду, |
1070
73b31b44d3a0
Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1069
diff
changeset
|
443 если разрешена передача команды |
73b31b44d3a0
Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1069
diff
changeset
|
444 <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
|
445 </listitem> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
446 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
447 </list> |
1069
71e6daffa4dc
Documented behavior in the absence of the "server_name" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1068
diff
changeset
|
448 </para> |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
449 |
1069
71e6daffa4dc
Documented behavior in the absence of the "server_name" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1068
diff
changeset
|
450 <para> |
71e6daffa4dc
Documented behavior in the absence of the "server_name" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1068
diff
changeset
|
451 Если директива не указана, используется имя хоста (hostname) машины. |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
452 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
453 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
454 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
455 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
456 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
457 <directive name="timeout"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
458 <syntax><value>время</value></syntax> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
459 <default>60s</default> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
460 <context>mail</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
461 <context>server</context> |
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 <para> |
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 </para> |
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 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
468 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
469 </section> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
470 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
471 </module> |