Mercurial > hg > nginx-site
annotate xml/ru/docs/mail/ngx_mail_core_module.xml @ 2705:06805824d0f0
Documented the keepalive_time directive.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 13 Apr 2021 15:05:16 +0100 |
parents | 5f961aa083db |
children | 1261698ec228 |
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" |
2691
5f961aa083db
Mentioned realip module in the listen directive for mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2690
diff
changeset
|
13 rev="17"> |
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 | 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>. |
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 |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
252 <directive name="protocol"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
253 <syntax> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
254 <literal>imap</literal> | |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
255 <literal>pop3</literal> | |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
256 <literal>smtp</literal></syntax> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
257 <default/> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
258 <context>server</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
259 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
260 <para> |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
636
diff
changeset
|
261 Задаёт протокол проксируемого сервера. |
643
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
262 Поддерживаются протоколы |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
636
diff
changeset
|
263 <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
|
264 <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
|
265 <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
|
266 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
267 |
643
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
268 <para> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
269 Если директива не указана, то протокол может быть определён автоматически |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
270 по общеизвестному порту, указанному в директиве <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
|
271 <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
|
272 |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
273 <listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
274 <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
|
275 </listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
276 |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
277 <listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
278 <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
|
279 </listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
280 |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
281 <listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
282 <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
|
283 </listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
284 |
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> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
286 </para> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
287 |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
288 <para> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
289 Поддержку ненужных протоколов можно отключить с помощью |
924 | 290 <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
|
291 параметров <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
|
292 <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
|
293 <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
|
294 </para> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
295 |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
296 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
297 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
298 |
1068
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
299 <directive name="resolver"> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
300 <syntax> |
2451
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
301 <value>адрес</value> ... |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
302 [<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
|
303 [<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
|
304 [<literal>status_zone</literal>=<value>зона</value>]</syntax> |
1068
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
305 <syntax><literal>off</literal></syntax> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
306 <default>off</default> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
307 <context>mail</context> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
308 <context>server</context> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
309 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
310 <para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
311 Задаёт серверы DNS, используемые для определения имени хоста клиента |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
312 для передачи его на |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
313 <link doc="ngx_mail_auth_http_module.xml">сервер аутентификации</link> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
314 и в команде |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
315 <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
|
316 при проксировании SMTP. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
317 Например: |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
318 <example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
319 resolver 127.0.0.1 [::1]:5353; |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
320 </example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
321 Адрес может быть указан в виде доменного имени или IP-адреса, |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
322 и необязательного порта (1.3.1, 1.2.2). |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
323 Если порт не указан, используется порт 53. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
324 Серверы DNS опрашиваются циклически. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
325 <note> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
326 До версии 1.1.7 можно было задать лишь один DNS-сервер. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
327 Задание DNS-серверов с помощью IPv6-адресов поддерживается |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
328 начиная с версий 1.3.1 и 1.2.2. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
329 </note> |
2452
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2451
diff
changeset
|
330 </para> |
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2451
diff
changeset
|
331 |
2453
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
332 <para id="resolver_ipv6"> |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
333 По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
334 при преобразовании имён в адреса. |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
335 Если поиск IPv6-адресов нежелателен, |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
336 можно указать параметр <literal>ipv6=off</literal>. |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
337 <note> |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
338 Преобразование имён в IPv6-адреса поддерживается |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
339 начиная с версии 1.5.8. |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
340 </note> |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
341 </para> |
1b0cc44de0fd
Documented the "ipv6=" parameter for resolver in mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2452
diff
changeset
|
342 |
2452
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2451
diff
changeset
|
343 <para id="resolver_valid"> |
1068
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
344 По умолчанию nginx кэширует ответы, используя значение TTL из ответа. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
345 Необязательный параметр <literal>valid</literal> позволяет это |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
346 переопределить: |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
347 <example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
348 resolver 127.0.0.1 [::1]:5353 valid=30s; |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
349 </example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
350 <note> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
351 До версии 1.1.9 настройка времени кэширования была невозможна |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
352 и nginx всегда кэшировал ответы на срок в 5 минут. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
353 </note> |
2471
c8f0f30e1513
Added a note about DNS spoofing to all "resolver" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
2453
diff
changeset
|
354 <note> |
c8f0f30e1513
Added a note about DNS spoofing to all "resolver" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
2453
diff
changeset
|
355 Для предотвращения DNS-спуфинга рекомендуется |
c8f0f30e1513
Added a note about DNS spoofing to all "resolver" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
2453
diff
changeset
|
356 использовать DNS-серверы в защищённой доверенной локальной сети. |
c8f0f30e1513
Added a note about DNS spoofing to all "resolver" directives.
Ruslan Ermilov <ru@nginx.com>
parents:
2453
diff
changeset
|
357 </note> |
1068
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
358 </para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
359 |
2451
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
360 <para id="resolver_status_zone"> |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
361 Необязательный параметр <literal>status_zone</literal> (1.17.1) |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
362 включает |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
363 <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
|
364 о запросах и ответах сервера DNS |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
365 в указанной <value>зоне</value>. |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
366 Параметр доступен как часть |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
367 <commercial_version>коммерческой подписки</commercial_version>. |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
368 </para> |
721f78cff4ef
Documented resolver statistics for stream and mail.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1963
diff
changeset
|
369 |
2452
4487310de7e7
Added IDs to resolver parameters, minor language fixes in resolver.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2451
diff
changeset
|
370 <para id="resolver_off"> |
1068
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
371 Специальное значение <literal>off</literal> запрещает использование DNS. |
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 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
374 </directive> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
375 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
376 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
377 <directive name="resolver_timeout"> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
378 <syntax><value>время</value></syntax> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
379 <default>30s</default> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
380 <context>mail</context> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
381 <context>server</context> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
382 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
383 <para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
384 Задаёт таймаут для операций DNS, например: |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
385 <example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
386 resolver_timeout 5s; |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
387 </example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
388 </para> |
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 </directive> |
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 |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
393 <directive name="server"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
394 <syntax block="yes"/> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
395 <default/> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
396 <context>mail</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
397 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
398 <para> |
751
9c1ffd02f1b7
Removed "virtual" and HTTPS references from mail modules.
Vladimir Homutov <vl@nginx.com>
parents:
748
diff
changeset
|
399 Задаёт конфигурацию для сервера. |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
400 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
401 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
402 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
403 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
404 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
405 <directive name="server_name"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
406 <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
|
407 <default>hostname</default> |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
408 <context>mail</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
409 <context>server</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
410 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
411 <para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
412 Задаёт имя сервера, используемое: |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
413 <list type="bullet"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
414 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
415 <listitem> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
416 в начальном приветствии POP3/SMTP-сервера; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
417 </listitem> |
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 <listitem> |
641 | 420 в salt при аутентификации SASL-методом CRAM-MD5; |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
421 </listitem> |
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 <listitem> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
424 в команде <literal>EHLO</literal> при подключении к SMTP-бэкенду, |
1070
73b31b44d3a0
Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1069
diff
changeset
|
425 если разрешена передача команды |
73b31b44d3a0
Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1069
diff
changeset
|
426 <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
|
427 </listitem> |
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 </list> |
1069
71e6daffa4dc
Documented behavior in the absence of the "server_name" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1068
diff
changeset
|
430 </para> |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
431 |
1069
71e6daffa4dc
Documented behavior in the absence of the "server_name" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1068
diff
changeset
|
432 <para> |
71e6daffa4dc
Documented behavior in the absence of the "server_name" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1068
diff
changeset
|
433 Если директива не указана, используется имя хоста (hostname) машины. |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
434 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
435 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
436 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
437 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
438 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
439 <directive name="timeout"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
440 <syntax><value>время</value></syntax> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
441 <default>60s</default> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
442 <context>mail</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
443 <context>server</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
444 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
445 <para> |
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 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
448 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
449 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
450 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
451 </section> |
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 </module> |