Mercurial > hg > nginx-site
annotate xml/ru/docs/mail/ngx_mail_core_module.xml @ 1495:8d134b482cc3
Documented zone usage with many upstreams.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Wed, 27 May 2015 18:06:02 +0300 |
parents | 9f9b8543b946 |
children | b628e042a15e |
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" |
1489
9f9b8543b946
Relocated phrase in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1488
diff
changeset
|
13 rev="6"> |
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> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
30 worker_processes 1; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
31 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
32 error_log /var/log/nginx/error.log info; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
33 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
34 mail { |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
35 server_name mail.example.com; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
36 auth_http localhost:9000/cgi-bin/nginxauth.cgi; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
37 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
38 imap_capabilities IMAP4rev1 UIDPLUS IDLE LITERAL+ QUOTA; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
39 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
40 pop3_auth plain apop cram-md5; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
41 pop3_capabilities LAST TOP USER PIPELINING UIDL; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
42 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
43 smtp_auth login plain cram-md5; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
44 smtp_capabilities "SIZE 10485760" ENHANCEDSTATUSCODES 8BITMIME DSN; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
45 xclient off; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
46 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
47 server { |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
48 listen 25; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
49 protocol smtp; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
50 } |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
51 server { |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
52 listen 110; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
53 protocol pop3; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
54 proxy_pass_error_message on; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
55 } |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
56 server { |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
57 listen 143; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
58 protocol imap; |
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 587; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
62 protocol smtp; |
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 } |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
65 </example> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
66 </para> |
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 </section> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
69 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
70 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
71 <section id="directives" name="Директивы"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
72 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
73 <directive name="listen"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
74 <syntax> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
75 <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
|
76 [<literal>ssl</literal>] |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
77 [<literal>bind</literal>] |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
78 [<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
|
79 [<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
|
80 <default/> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
81 <context>server</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
82 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
83 <para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
84 Задаёт <value>адрес</value> и <value>порт</value> сокета, на котором сервер |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
85 будет принимать запросы. |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
86 Можно указать только порт. |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
87 Кроме того, адрес может быть именем сервера, например: |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
88 <example> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
89 listen 127.0.0.1:110; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
90 listen *:110; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
91 listen 110; # то же, что и *:110 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
92 listen localhost:110; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
93 </example> |
644
b4d15f1c7c06
Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents:
643
diff
changeset
|
94 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
|
95 <example> |
b4d15f1c7c06
Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents:
643
diff
changeset
|
96 listen [::1]:110; |
b4d15f1c7c06
Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents:
643
diff
changeset
|
97 listen [::]:110; |
b4d15f1c7c06
Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents:
643
diff
changeset
|
98 </example> |
b4d15f1c7c06
Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents:
643
diff
changeset
|
99 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
|
100 <example> |
b4d15f1c7c06
Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents:
643
diff
changeset
|
101 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
|
102 </example> |
b4d15f1c7c06
Documented IPv6 and AF_UNIX sockets support for client mail connections.
Ruslan Ermilov <ru@nginx.com>
parents:
643
diff
changeset
|
103 |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
104 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
105 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
106 <para> |
1489
9f9b8543b946
Relocated phrase in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1488
diff
changeset
|
107 Разные серверы должны слушать на разных парах |
9f9b8543b946
Relocated phrase in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1488
diff
changeset
|
108 <value>адрес</value>:<value>порт</value>. |
9f9b8543b946
Relocated phrase in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1488
diff
changeset
|
109 </para> |
9f9b8543b946
Relocated phrase in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1488
diff
changeset
|
110 |
9f9b8543b946
Relocated phrase in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1488
diff
changeset
|
111 <para> |
1488
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
112 Параметр <literal>ssl</literal> указывает на то, что все соединения, |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
113 принимаемые на данном порту, должны работать в режиме SSL. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
114 </para> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
115 |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
116 <para> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
117 В директиве <literal>listen</literal> можно также указать несколько |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
118 дополнительных параметров, специфичных для связанных с сокетами |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
119 системных вызовов. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
120 <list type="tag"> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
121 |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
122 <tag-name> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
123 <literal>bind</literal> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
124 </tag-name> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
125 <tag-desc> |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
126 указывает, что для данной пары |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
127 <value>адрес</value>:<value>порт</value> нужно делать |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
128 <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
|
129 Это нужно потому, что если описаны несколько директив <literal>listen</literal> |
966 | 130 с одинаковым портом, но разными адресами, и одна из директив |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
131 <literal>listen</literal> слушает на всех адресах для данного порта |
966 | 132 (<literal>*:</literal><value>порт</value>), то nginx сделает |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
133 <c-func>bind</c-func> только на <literal>*:</literal><value>порт</value>. |
1046 | 134 Необходимо заметить, что в этом случае для определения адреса, на который |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
135 пришло соединение, делается системный вызов <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
|
136 Если же используются параметры <literal>ipv6only</literal> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
137 или <literal>so_keepalive</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 <value>адрес</value>:<value>порт</value> всегда делается |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
140 отдельный вызов <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
|
141 </tag-desc> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
142 |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
143 <tag-name> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
144 <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
|
145 </tag-name> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
146 <tag-desc> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
147 этот параметр определяет |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
148 (через параметр сокета <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
|
149 будет ли слушающий на wildcard-адресе <literal>[::]</literal> IPv6-сокет |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
150 принимать только IPv6-соединения, или же одновременно IPv6- и IPv4-соединения. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
151 По умолчанию параметр включён. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
152 Установить его можно только один раз на старте. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
153 </tag-desc> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
154 |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
155 <tag-name> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
156 <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
|
157 </tag-name> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
158 <tag-desc> |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
159 этот параметр конфигурирует для слушающего сокета |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
160 поведение “TCP keepalive”. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
161 Если этот параметр опущен, то для сокета будут действовать |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
162 настройки операционной системы. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
163 Если он установлен в значение “<literal>on</literal>”, то для сокета |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
164 включается параметр <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
|
165 Если он установлен в значение “<literal>off</literal>”, то для сокета |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
166 параметр <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
|
167 Некоторые операционные системы поддерживают настройку параметров |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
168 “TCP keepalive” на уровне сокета посредством параметров |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
169 <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
|
170 <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
|
171 На таких системах (в настоящий момент это 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
|
172 FreeBSD 9.0-STABLE) |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
173 их можно сконфигурировать с помощью параметров <value>keepidle</value>, |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
174 <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
|
175 Один или два параметра могут быть опущены, в таком случае для |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
176 соответствующего параметра сокета будут действовать стандартные |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
177 системные настройки. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
178 Например, |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
179 <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
|
180 установит таймаут бездействия (<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
|
181 для интервала проб (<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
|
182 стандартная системная настройка, а счётчик проб (<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
|
183 будет равен 10. |
0a1c5a087556
Documented bind/ipv6only/ssl/so_keepalive in mail listen directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1471
diff
changeset
|
184 </tag-desc> |
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 </list> |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
187 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
188 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
189 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
190 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
191 |
748
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
192 <directive name="mail"> |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
193 <syntax block="yes"/> |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
194 <default/> |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
195 <context>main</context> |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
196 |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
197 <para> |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
198 Предоставляет контекст конфигурационного файла, в котором указываются |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
199 директивы почтового сервера. |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
200 </para> |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
201 |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
202 </directive> |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
203 |
95344046d2d8
Documented 'mail' directive.
Vladimir Homutov <vl@nginx.com>
parents:
644
diff
changeset
|
204 |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
205 <directive name="protocol"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
206 <syntax> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
207 <literal>imap</literal> | |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
208 <literal>pop3</literal> | |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
209 <literal>smtp</literal></syntax> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
210 <default/> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
211 <context>server</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
212 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
213 <para> |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
636
diff
changeset
|
214 Задаёт протокол проксируемого сервера. |
643
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
215 Поддерживаются протоколы |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
636
diff
changeset
|
216 <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
|
217 <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
|
218 <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
|
219 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
220 |
643
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
221 <para> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
222 Если директива не указана, то протокол может быть определён автоматически |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
223 по общеизвестному порту, указанному в директиве <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
|
224 <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
|
225 |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
226 <listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
227 <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
|
228 </listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
229 |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
230 <listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
231 <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
|
232 </listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
233 |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
234 <listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
235 <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
|
236 </listitem> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
237 |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
238 </list> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
239 </para> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
240 |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
241 <para> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
242 Поддержку ненужных протоколов можно отключить с помощью |
924 | 243 <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
|
244 параметров <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
|
245 <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
|
246 <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
|
247 </para> |
b2159031ff19
Documented well-known ports that can be used to auto-detect mail protocol.
Ruslan Ermilov <ru@nginx.com>
parents:
642
diff
changeset
|
248 |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
249 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
250 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
251 |
1068
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
252 <directive name="resolver"> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
253 <syntax> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
254 <value>адрес</value> ... |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
255 [<literal>valid</literal>=<value>время</value>]</syntax> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
256 <syntax><literal>off</literal></syntax> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
257 <default>off</default> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
258 <context>mail</context> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
259 <context>server</context> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
260 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
261 <para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
262 Задаёт серверы DNS, используемые для определения имени хоста клиента |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
263 для передачи его на |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
264 <link doc="ngx_mail_auth_http_module.xml">сервер аутентификации</link> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
265 и в команде |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
266 <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
|
267 при проксировании SMTP. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
268 Например: |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
269 <example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
270 resolver 127.0.0.1 [::1]:5353; |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
271 </example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
272 Адрес может быть указан в виде доменного имени или IP-адреса, |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
273 и необязательного порта (1.3.1, 1.2.2). |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
274 Если порт не указан, используется порт 53. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
275 Серверы DNS опрашиваются циклически. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
276 <note> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
277 До версии 1.1.7 можно было задать лишь один DNS-сервер. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
278 Задание DNS-серверов с помощью IPv6-адресов поддерживается |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
279 начиная с версий 1.3.1 и 1.2.2. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
280 </note> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
281 По умолчанию nginx кэширует ответы, используя значение TTL из ответа. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
282 Необязательный параметр <literal>valid</literal> позволяет это |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
283 переопределить: |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
284 <example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
285 resolver 127.0.0.1 [::1]:5353 valid=30s; |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
286 </example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
287 <note> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
288 До версии 1.1.9 настройка времени кэширования была невозможна |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
289 и nginx всегда кэшировал ответы на срок в 5 минут. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
290 </note> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
291 </para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
292 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
293 <para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
294 Специальное значение <literal>off</literal> запрещает использование DNS. |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
295 </para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
296 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
297 </directive> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
298 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
299 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
300 <directive name="resolver_timeout"> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
301 <syntax><value>время</value></syntax> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
302 <default>30s</default> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
303 <context>mail</context> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
304 <context>server</context> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
305 |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
306 <para> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
307 Задаёт таймаут для операций DNS, например: |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
308 <example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
309 resolver_timeout 5s; |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
310 </example> |
0c5f8630fe40
Documented the mail "resolver" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1067
diff
changeset
|
311 </para> |
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 </directive> |
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 |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
316 <directive name="server"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
317 <syntax block="yes"/> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
318 <default/> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
319 <context>mail</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
320 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
321 <para> |
751
9c1ffd02f1b7
Removed "virtual" and HTTPS references from mail modules.
Vladimir Homutov <vl@nginx.com>
parents:
748
diff
changeset
|
322 Задаёт конфигурацию для сервера. |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
323 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
324 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
325 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
326 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
327 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
328 <directive name="server_name"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
329 <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
|
330 <default>hostname</default> |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
331 <context>mail</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
332 <context>server</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
333 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
334 <para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
335 Задаёт имя сервера, используемое: |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
336 <list type="bullet"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
337 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
338 <listitem> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
339 в начальном приветствии POP3/SMTP-сервера; |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
340 </listitem> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
341 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
342 <listitem> |
641 | 343 в salt при аутентификации SASL-методом CRAM-MD5; |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
344 </listitem> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
345 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
346 <listitem> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
347 в команде <literal>EHLO</literal> при подключении к SMTP-бэкенду, |
1070
73b31b44d3a0
Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1069
diff
changeset
|
348 если разрешена передача команды |
73b31b44d3a0
Updated and simplified the "xclient" directive description.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1069
diff
changeset
|
349 <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
|
350 </listitem> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
351 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
352 </list> |
1069
71e6daffa4dc
Documented behavior in the absence of the "server_name" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1068
diff
changeset
|
353 </para> |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
354 |
1069
71e6daffa4dc
Documented behavior in the absence of the "server_name" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1068
diff
changeset
|
355 <para> |
71e6daffa4dc
Documented behavior in the absence of the "server_name" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1068
diff
changeset
|
356 Если директива не указана, используется имя хоста (hostname) машины. |
630
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
357 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
358 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
359 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
360 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
361 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
362 <directive name="timeout"> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
363 <syntax><value>время</value></syntax> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
364 <default>60s</default> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
365 <context>mail</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
366 <context>server</context> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
367 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
368 <para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
369 Задаёт таймаут, который используется до начала проксирования на бэкенд. |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
370 </para> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
371 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
372 </directive> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
373 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
374 </section> |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
375 |
a235ce0f8eef
Initial mail proxy server documentation in Russian.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
376 </module> |