Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_grpc_module.xml @ 2846:fdf1464e1977
Moved banner to the external file to make partial rollout possible.
An idea is to have several banners and show them with different probability
specified by split directive in the nginx.conf
author | Sergey Budnevitch <sb@waeme.net> |
---|---|
date | Tue, 10 May 2022 18:07:27 +0400 |
parents | 92e5dca02091 |
children | 0d355d154181 |
rev | line source |
---|---|
222
bfe3eff81d04
Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents:
135
diff
changeset
|
1 <?xml version="1.0"?> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2 |
580
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
3 <!-- |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
4 Copyright (C) Igor Sysoev |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
5 Copyright (C) Nginx, Inc. |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
6 --> |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
7 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
9 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
10 <module name="Модуль ngx_http_grpc_module" |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
11 link="/ru/docs/http/ngx_http_grpc_module.html" |
589 | 12 lang="ru" |
2837
92e5dca02091
Corrected syntax of ssl_conf_command and friends.
Dj Gilcrease <d.gilcrease@f5.com>
parents:
2831
diff
changeset
|
13 rev="7"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
14 |
110
40eec261c2a6
Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
15 <section id="summary"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
16 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
17 <para> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
18 Модуль <literal>ngx_http_grpc_module</literal> позволяет передавать запросы |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
19 gRPC-серверу (1.13.10). |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
20 Для работы этого модуля необходим |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
21 модуль <link doc="ngx_http_v2_module.xml">ngx_http_v2_module</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
22 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
23 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
24 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
25 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
26 |
361 | 27 <section id="example" name="Пример конфигурации"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
28 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
29 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
30 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
31 server { |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
32 listen 9000 http2; |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
33 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
34 location / { |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
35 grpc_pass 127.0.0.1:9000; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
36 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
37 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
38 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
39 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
40 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
41 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
42 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
43 |
361 | 44 <section id="directives" name="Директивы"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
45 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
46 <directive name="grpc_bind"> |
1885
6839c258c473
Added <literal> tag to proxy bind transparent.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1748
diff
changeset
|
47 <syntax> |
6839c258c473
Added <literal> tag to proxy bind transparent.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1748
diff
changeset
|
48 <value>адрес</value> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
49 [<literal>transparent </literal>] | |
1885
6839c258c473
Added <literal> tag to proxy bind transparent.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1748
diff
changeset
|
50 <literal>off</literal></syntax> |
772
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
677
diff
changeset
|
51 <default/> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
677
diff
changeset
|
52 <context>http</context> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
677
diff
changeset
|
53 <context>server</context> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
677
diff
changeset
|
54 <context>location</context> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
677
diff
changeset
|
55 |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
677
diff
changeset
|
56 <para> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
57 Задаёт локальный IP-адрес с необязательным портом, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
58 который будет использоваться в исходящих соединениях с gRPC-сервером. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
59 В значении параметра допустимо использование переменных. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
60 Специальное значение <literal>off</literal> отменяет действие |
815
ed29fd8be462
*_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents:
814
diff
changeset
|
61 унаследованной с предыдущего уровня конфигурации |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
62 директивы <literal>grpc_bind</literal>, позволяя системе |
1748
be371be7a5c8
Documented optional port for proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1696
diff
changeset
|
63 самостоятельно выбирать локальный IP-адрес и порт. |
772
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
677
diff
changeset
|
64 </para> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
677
diff
changeset
|
65 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
66 <para id="grpc_bind_transparent"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
67 Параметр <literal>transparent</literal> позволяет |
1696
d855e7cc3b2f
Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1672
diff
changeset
|
68 задать нелокальный IP-aдрес, который будет использоваться в |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
69 исходящих соединениях с gRPC-сервером, |
1696
d855e7cc3b2f
Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1672
diff
changeset
|
70 например, реальный IP-адрес клиента: |
d855e7cc3b2f
Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1672
diff
changeset
|
71 <example> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
72 grpc_bind $remote_addr transparent; |
1696
d855e7cc3b2f
Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1672
diff
changeset
|
73 </example> |
d855e7cc3b2f
Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1672
diff
changeset
|
74 Для работы параметра |
2090
a9a9a052b5bd
Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1885
diff
changeset
|
75 обычно требуется |
a9a9a052b5bd
Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1885
diff
changeset
|
76 запустить рабочие процессы nginx с привилегиями |
a9a9a052b5bd
Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1885
diff
changeset
|
77 <link doc="../ngx_core_module.xml" id="user">суперпользователя</link>. |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
78 В Linux этого не требуется, так как если |
2090
a9a9a052b5bd
Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1885
diff
changeset
|
79 указан параметр <literal>transparent</literal>, то рабочие процессы |
a9a9a052b5bd
Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1885
diff
changeset
|
80 наследуют capability <literal>CAP_NET_RAW</literal> из главного процесса. |
a9a9a052b5bd
Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1885
diff
changeset
|
81 Также необходимо настроить таблицу маршрутизации ядра |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
82 для перехвата сетевого трафика с gRPC-сервера. |
1696
d855e7cc3b2f
Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1672
diff
changeset
|
83 </para> |
d855e7cc3b2f
Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1672
diff
changeset
|
84 |
772
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
677
diff
changeset
|
85 </directive> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
677
diff
changeset
|
86 |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
677
diff
changeset
|
87 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
88 <directive name="grpc_buffer_size"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
89 <syntax><value>размер</value></syntax> |
361 | 90 <default>4k|8k</default> |
91 <context>http</context> | |
92 <context>server</context> | |
93 <context>location</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
94 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
95 <para> |
361 | 96 Задаёт <value>размер</value> буфера, в который будет читаться ответ, |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
97 получаемый от gRPC-сервера. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
98 Ответ синхронно передаётся клиенту сразу же по мере его поступления. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
99 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
100 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
101 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
102 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
103 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
104 <directive name="grpc_connect_timeout"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
105 <syntax><value>время</value></syntax> |
361 | 106 <default>60s</default> |
107 <context>http</context> | |
108 <context>server</context> | |
109 <context>location</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
110 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
111 <para> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
112 Задаёт таймаут для установления соединения с gRPC-сервером. |
361 | 113 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
114 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
115 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
116 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
117 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
118 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
119 <directive name="grpc_hide_header"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
120 <syntax><value>поле</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
121 <default/> |
1337
91a064bdb4f9
Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1290
diff
changeset
|
122 <context>http</context> |
91a064bdb4f9
Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1290
diff
changeset
|
123 <context>server</context> |
91a064bdb4f9
Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1290
diff
changeset
|
124 <context>location</context> |
91a064bdb4f9
Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1290
diff
changeset
|
125 |
91a064bdb4f9
Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1290
diff
changeset
|
126 <para> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
127 По умолчанию |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
128 nginx не передаёт клиенту поля заголовка <header>Date</header>, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
129 <header>Server</header> и |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
130 <header>X-Accel-...</header> из ответа gRPC-сервера. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
131 Директива <literal>grpc_hide_header</literal> задаёт дополнительные поля, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
132 которые не будут передаваться. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
133 Если же передачу полей нужно разрешить, можно воспользоваться |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
134 директивой <link id="grpc_pass_header"/>. |
1337
91a064bdb4f9
Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1290
diff
changeset
|
135 </para> |
91a064bdb4f9
Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1290
diff
changeset
|
136 |
91a064bdb4f9
Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1290
diff
changeset
|
137 </directive> |
91a064bdb4f9
Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1290
diff
changeset
|
138 |
91a064bdb4f9
Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1290
diff
changeset
|
139 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
140 <directive name="grpc_ignore_headers"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
141 <syntax><value>поле</value> ...</syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
142 <default/> |
675
08140f6b7964
Documented gunzip module and corresponding changes.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
143 <context>http</context> |
08140f6b7964
Documented gunzip module and corresponding changes.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
144 <context>server</context> |
08140f6b7964
Documented gunzip module and corresponding changes.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
145 <context>location</context> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
146 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
147 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
148 Запрещает обработку некоторых полей заголовка из ответа gRPC-сервера. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
149 В директиве можно указать поля <header>X-Accel-Redirect</header> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
150 и <header>X-Accel-Charset</header>. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
151 </para> |
675
08140f6b7964
Documented gunzip module and corresponding changes.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
152 |
08140f6b7964
Documented gunzip module and corresponding changes.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
153 <para> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
154 Если не запрещено, обработка этих полей заголовка заключается в следующем: |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
155 <list type="bullet" compact="no"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
156 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
157 <listitem> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
158 <header>X-Accel-Redirect</header> производит |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
159 <link doc="ngx_http_core_module.xml" id="internal">внутреннее |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
160 перенаправление</link> на указанный URI; |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
161 </listitem> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
162 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
163 <listitem> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
164 <header>X-Accel-Charset</header> задаёт желаемую |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
165 <link doc="ngx_http_charset_module.xml" id="charset">кодировку</link> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
166 ответа. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
167 </listitem> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
168 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
169 </list> |
675
08140f6b7964
Documented gunzip module and corresponding changes.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
170 </para> |
08140f6b7964
Documented gunzip module and corresponding changes.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
171 |
08140f6b7964
Documented gunzip module and corresponding changes.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
172 </directive> |
08140f6b7964
Documented gunzip module and corresponding changes.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
173 |
08140f6b7964
Documented gunzip module and corresponding changes.
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
174 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
175 <directive name="grpc_intercept_errors"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
176 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
177 <default>off</default> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
178 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
179 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
180 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
181 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
182 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
183 Определяет, передавать ли клиенту ответы gRPC-сервера с кодом |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
184 больше либо равным 300, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
185 или же перехватывать их и перенаправлять на обработку nginx’у с помощью |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
186 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
187 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
188 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
189 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
190 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
191 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
192 <directive name="grpc_next_upstream"> |
271 | 193 <syntax> |
364 | 194 <literal>error</literal> | |
195 <literal>timeout</literal> | | |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
196 <literal>invalid_header</literal> | |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
197 <literal>http_500</literal> | |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
198 <literal>http_502</literal> | |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
199 <literal>http_503</literal> | |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
200 <literal>http_504</literal> | |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
201 <literal>http_403</literal> | |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
202 <literal>http_404</literal> | |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
203 <literal>http_429</literal> | |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
204 <literal>non_idempotent</literal> | |
364 | 205 <literal>off</literal> |
206 ...</syntax> | |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
207 <default>error timeout</default> |
361 | 208 <context>http</context> |
209 <context>server</context> | |
210 <context>location</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
211 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
212 <para> |
361 | 213 Определяет, в каких случаях запрос будет передан следующему серверу: |
214 <list type="tag"> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
215 |
361 | 216 <tag-name><literal>error</literal></tag-name> |
217 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или | |
218 чтения заголовка ответа сервера;</tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
219 |
361 | 220 <tag-name><literal>timeout</literal></tag-name> |
221 <tag-desc>произошёл таймаут во время соединения с сервером, | |
222 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
223 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
224 <tag-name><literal>invalid_header</literal></tag-name> |
361 | 225 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
226 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
227 <tag-name><literal>http_500</literal></tag-name> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
228 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
229 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
230 <tag-name><literal>http_502</literal></tag-name> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
231 <tag-desc>сервер вернул ответ с кодом 502;</tag-desc> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
232 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
233 <tag-name><literal>http_503</literal></tag-name> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
234 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
235 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
236 <tag-name><literal>http_504</literal></tag-name> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
237 <tag-desc>сервер вернул ответ с кодом 504;</tag-desc> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
238 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
239 <tag-name><literal>http_403</literal></tag-name> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
240 <tag-desc>сервер вернул ответ с кодом 403;</tag-desc> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
241 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
242 <tag-name><literal>http_404</literal></tag-name> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
243 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
244 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
245 <tag-name><literal>http_429</literal></tag-name> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
246 <tag-desc>сервер вернул ответ с кодом 429;</tag-desc> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
247 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
248 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
249 <tag-desc>обычно запросы с |
2831
4add6ae1296f
Updated links to datatracker.ietf.org.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2721
diff
changeset
|
250 <link url="https://datatracker.ietf.org/doc/html/rfc7231#section-4.2.2">неидемпотентным</link> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
251 методом |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
252 (<literal>POST</literal>, <literal>LOCK</literal>, <literal>PATCH</literal>) |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
253 не передаются на другой сервер, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
254 если запрос серверу группы уже был отправлен; |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
255 включение параметра явно разрешает повторять подобные запросы; |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
256 </tag-desc> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
257 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
258 |
361 | 259 <tag-name><literal>off</literal></tag-name> |
260 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
261 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
262 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
263 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
264 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
265 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
266 Необходимо понимать, что передача запроса следующему серверу возможна |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
267 только при условии, что клиенту ещё ничего не передавалось. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
268 То есть, если ошибка или таймаут возникли в середине передачи ответа, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
269 то исправить это уже невозможно. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
270 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
271 |
942
ba3d6ade3513
Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents:
815
diff
changeset
|
272 <para> |
1289
57fc39924d42
Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1157
diff
changeset
|
273 Директива также определяет, что считается |
57fc39924d42
Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1157
diff
changeset
|
274 <link doc="ngx_http_upstream_module.xml" id="max_fails">неудачной |
57fc39924d42
Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1157
diff
changeset
|
275 попыткой</link> работы с сервером. |
942
ba3d6ade3513
Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents:
815
diff
changeset
|
276 Случаи <literal>error</literal>, <literal>timeout</literal> и |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
277 <literal>invalid_header</literal> |
942
ba3d6ade3513
Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents:
815
diff
changeset
|
278 всегда считаются неудачными попытками, даже если они не указаны в директиве. |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
279 Случаи <literal>http_500</literal>, <literal>http_502</literal>, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
280 <literal>http_503</literal>, <literal>http_504</literal> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
281 и <literal>http_429</literal> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
282 считаются неудачными попытками, только если они указаны в директиве. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
283 Случаи <literal>http_403</literal> и <literal>http_404</literal> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
284 никогда не считаются неудачными попытками. |
942
ba3d6ade3513
Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents:
815
diff
changeset
|
285 </para> |
ba3d6ade3513
Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents:
815
diff
changeset
|
286 |
1290
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
287 <para> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
288 Передача запроса следующему серверу может быть ограничена по |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
289 <link id="grpc_next_upstream_tries">количеству попыток</link> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
290 и по <link id="grpc_next_upstream_timeout">времени</link>. |
1290
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
291 </para> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
292 |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
293 </directive> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
294 |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
295 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
296 <directive name="grpc_next_upstream_timeout"> |
1290
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
297 <syntax><value>время</value></syntax> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
298 <default>0</default> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
299 <context>http</context> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
300 <context>server</context> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
301 <context>location</context> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
302 |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
303 <para> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
304 Ограничивает время, в течение которого возможна передача запроса |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
305 <link id="grpc_next_upstream">следующему серверу</link>. |
1290
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
306 Значение <literal>0</literal> отключает это ограничение. |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
307 </para> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
308 |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
309 </directive> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
310 |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
311 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
312 <directive name="grpc_next_upstream_tries"> |
1290
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
313 <syntax><value>число</value></syntax> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
314 <default>0</default> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
315 <context>http</context> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
316 <context>server</context> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
317 <context>location</context> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
318 |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
319 <para> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
320 Ограничивает число допустимых попыток для передачи запроса |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
321 <link id="grpc_next_upstream">следующему серверу</link>. |
1290
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
322 Значение <literal>0</literal> отключает это ограничение. |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
323 </para> |
f5cc9f2aef9a
Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1289
diff
changeset
|
324 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
325 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
326 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
327 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
328 <directive name="grpc_pass"> |
361 | 329 <syntax><value>адрес</value></syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
76
diff
changeset
|
330 <default/> |
361 | 331 <context>location</context> |
332 <context>if в location</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
333 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
334 <para> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
335 Задаёт адрес gRPC-сервера. |
1622
c4c1dddfedac
Unified *_pass address descriptions.
Ruslan Ermilov <ru@nginx.com>
parents:
1337
diff
changeset
|
336 Адрес может быть указан в виде доменного имени или IP-адреса, |
c4c1dddfedac
Unified *_pass address descriptions.
Ruslan Ermilov <ru@nginx.com>
parents:
1337
diff
changeset
|
337 и порта: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
338 <example> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
339 grpc_pass localhost:9000; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
340 </example> |
814
f46a132af596
"memcached_pass" can be a UNIX-domain socket.
Ruslan Ermilov <ru@nginx.com>
parents:
772
diff
changeset
|
341 или в виде пути UNIX-сокета: |
f46a132af596
"memcached_pass" can be a UNIX-domain socket.
Ruslan Ermilov <ru@nginx.com>
parents:
772
diff
changeset
|
342 <example> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
343 grpc_pass unix:/tmp/grpc.socket; |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
344 </example> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
345 Также может использоваться схема “<literal>grpc://</literal>”: |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
346 <example> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
347 grpc_pass grpc://127.0.0.1:9000; |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
348 </example> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
349 Для использования gRPC по SSL необходимо использовать схему |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
350 “<literal>grpcs://</literal>”: |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
351 <example> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
352 grpc_pass grpcs://127.0.0.1:443; |
814
f46a132af596
"memcached_pass" can be a UNIX-domain socket.
Ruslan Ermilov <ru@nginx.com>
parents:
772
diff
changeset
|
353 </example> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
354 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
355 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
356 <para> |
361 | 357 Если доменному имени соответствует несколько адресов, то все они будут |
358 использоваться по очереди (round-robin). | |
359 И, кроме того, адрес может быть | |
135
edf8c90f8085
Renamed ngx_http_upstream to ngx_http_upstream_module.
Ruslan Ermilov <ru@nginx.com>
parents:
110
diff
changeset
|
360 <link doc="ngx_http_upstream_module.xml">группой серверов</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
361 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
362 |
2477
bdc7cacb164f
Documented variables support in grpc_pass.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2254
diff
changeset
|
363 <para> |
bdc7cacb164f
Documented variables support in grpc_pass.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2254
diff
changeset
|
364 В значении параметра можно использовать переменные (1.17.8). |
bdc7cacb164f
Documented variables support in grpc_pass.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2254
diff
changeset
|
365 В этом случае, если адрес указан в виде доменного имени, |
bdc7cacb164f
Documented variables support in grpc_pass.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2254
diff
changeset
|
366 имя ищется среди описанных |
bdc7cacb164f
Documented variables support in grpc_pass.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2254
diff
changeset
|
367 <link doc="ngx_http_upstream_module.xml">групп серверов</link> |
bdc7cacb164f
Documented variables support in grpc_pass.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2254
diff
changeset
|
368 и если не найдено, то определяется с помощью |
bdc7cacb164f
Documented variables support in grpc_pass.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2254
diff
changeset
|
369 <link doc="ngx_http_core_module.xml" id="resolver"/>’а. |
bdc7cacb164f
Documented variables support in grpc_pass.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2254
diff
changeset
|
370 </para> |
bdc7cacb164f
Documented variables support in grpc_pass.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2254
diff
changeset
|
371 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
372 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
373 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
374 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
375 <directive name="grpc_pass_header"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
376 <syntax><value>поле</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
377 <default/> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
378 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
379 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
380 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
381 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
382 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
383 Разрешает передавать от gRPC-сервера клиенту |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
384 <link id="grpc_hide_header">запрещённые для передачи</link> поля заголовка. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
385 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
386 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
387 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
388 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
389 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
390 <directive name="grpc_read_timeout"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
391 <syntax><value>время</value></syntax> |
361 | 392 <default>60s</default> |
393 <context>http</context> | |
394 <context>server</context> | |
395 <context>location</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
396 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
397 <para> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
398 Задаёт таймаут при чтении ответа gRPC-сервера. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
399 Таймаут устанавливается не на всю передачу ответа, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
400 а только между двумя операциями чтения. |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
401 Если по истечении этого времени gRPC-сервер ничего не передаст, |
361 | 402 соединение закрывается. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
403 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
404 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
405 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
406 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
407 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
408 <directive name="grpc_send_timeout"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
409 <syntax><value>время</value></syntax> |
361 | 410 <default>60s</default> |
411 <context>http</context> | |
412 <context>server</context> | |
413 <context>location</context> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
414 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
415 <para> |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
416 Задаёт таймаут при передаче запроса gRPC-серверу. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
417 Таймаут устанавливается не на всю передачу запроса, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
418 а только между двумя операциями записи. |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
419 Если по истечении этого времени gRPC-сервер не примет новых данных, |
361 | 420 соединение закрывается. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
421 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
422 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
423 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
424 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
425 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
426 <directive name="grpc_set_header"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
427 <syntax><value>поле</value> <value>значение</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
428 <default>Content-Length $content_length</default> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
429 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
430 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
431 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
432 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
433 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
434 Позволяет переопределять или добавлять поля заголовка запроса, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
435 <link id="proxy_pass_request_headers">передаваемые</link> gRPC-серверу. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
436 В качестве значения можно использовать текст, переменные и их комбинации. |
2593
eeed494bba51
Unified phrases about configuration levels and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents:
2477
diff
changeset
|
437 Директивы наследуются с предыдущего уровня конфигурации при условии, что |
eeed494bba51
Unified phrases about configuration levels and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents:
2477
diff
changeset
|
438 на данном уровне не описаны свои директивы <literal>grpc_set_header</literal>. |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
439 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
440 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
441 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
442 Если значение поля заголовка — пустая строка, то поле вообще |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
443 не будет передаваться gRPC-серверу: |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
444 <example> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
445 grpc_set_header Accept-Encoding ""; |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
446 </example> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
447 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
448 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
449 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
450 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
451 |
2254
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
452 <directive name="grpc_socket_keepalive"> |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
453 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
454 <default>off</default> |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
455 <context>http</context> |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
456 <context>server</context> |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
457 <context>location</context> |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
458 <appeared-in>1.15.6</appeared-in> |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
459 |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
460 <para> |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
461 Конфигурирует поведение “TCP keepalive” |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
462 для исходящих соединений к gRPC-серверу. |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
463 По умолчанию для сокета действуют настройки операционной системы. |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
464 Если указано значение “<literal>on</literal>”, то |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
465 для сокета включается параметр <c-def>SO_KEEPALIVE</c-def>. |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
466 </para> |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
467 |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
468 </directive> |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
469 |
d765ffffd08c
Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2142
diff
changeset
|
470 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
471 <directive name="grpc_ssl_certificate"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
472 <syntax><value>файл</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
473 <default/> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
474 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
475 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
476 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
477 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
478 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
479 Задаёт <value>файл</value> с сертификатом в формате PEM |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
480 для аутентификации на gRPC SSL-сервере. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
481 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
482 |
2721
7041bddec07d
Documented variables support for certificates in proxy, uwsgi, grpc.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2617
diff
changeset
|
483 <para> |
7041bddec07d
Documented variables support for certificates in proxy, uwsgi, grpc.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2617
diff
changeset
|
484 Начиная с версии 1.21.0 в имени файла можно использовать переменные. |
7041bddec07d
Documented variables support for certificates in proxy, uwsgi, grpc.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2617
diff
changeset
|
485 </para> |
7041bddec07d
Documented variables support for certificates in proxy, uwsgi, grpc.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2617
diff
changeset
|
486 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
487 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
488 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
489 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
490 <directive name="grpc_ssl_certificate_key"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
491 <syntax><value>файл</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
492 <default/> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
493 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
494 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
495 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
496 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
497 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
498 Задаёт <value>файл</value> с секретным ключом в формате PEM |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
499 для аутентификации на gRPC SSL-сервере. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
500 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
501 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
502 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
503 Вместо <value>файла</value> можно указать значение |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
504 <literal>engine</literal>:<value>имя</value>:<value>id</value>, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
505 которое загружает ключ с указанным <value>id</value> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
506 из OpenSSL engine с заданным <value>именем</value>. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
507 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
508 |
2721
7041bddec07d
Documented variables support for certificates in proxy, uwsgi, grpc.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2617
diff
changeset
|
509 <para> |
7041bddec07d
Documented variables support for certificates in proxy, uwsgi, grpc.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2617
diff
changeset
|
510 Начиная с версии 1.21.0 в имени файла можно использовать переменные. |
7041bddec07d
Documented variables support for certificates in proxy, uwsgi, grpc.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2617
diff
changeset
|
511 </para> |
7041bddec07d
Documented variables support for certificates in proxy, uwsgi, grpc.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2617
diff
changeset
|
512 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
513 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
514 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
515 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
516 <directive name="grpc_ssl_ciphers"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
517 <syntax><value>шифры</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
518 <default>DEFAULT</default> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
519 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
520 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
521 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
522 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
523 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
524 Описывает разрешённые шифры для запросов к gRPC SSL-серверу. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
525 Шифры задаются в формате, поддерживаемом библиотекой OpenSSL. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
526 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
527 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
528 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
529 Полный список можно посмотреть с помощью команды |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
530 “<command>openssl ciphers</command>”. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
531 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
532 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
533 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
534 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
535 |
2617
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
536 <directive name="grpc_ssl_conf_command"> |
2837
92e5dca02091
Corrected syntax of ssl_conf_command and friends.
Dj Gilcrease <d.gilcrease@f5.com>
parents:
2831
diff
changeset
|
537 <syntax><value>command</value> ...</syntax> |
2617
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
538 <default/> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
539 <context>http</context> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
540 <context>server</context> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
541 <context>location</context> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
542 <appeared-in>1.19.4</appeared-in> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
543 |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
544 <para> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
545 Задаёт произвольные конфигурационные |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
546 <link url="https://www.openssl.org/docs/man1.1.1/man3/SSL_CONF_cmd.html">команды</link> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
547 OpenSSL |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
548 при установлении соединения с gRPC SSL-сервером. |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
549 <note> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
550 Директива поддерживается при использовании OpenSSL 1.0.2 и выше. |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
551 </note> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
552 </para> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
553 |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
554 <para> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
555 На одном уровне может быть указано |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
556 несколько директив <literal>grpc_ssl_conf_command</literal>. |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
557 Директивы наследуются с предыдущего уровня конфигурации при условии, что |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
558 на данном уровне не описаны |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
559 свои директивы <literal>grpc_ssl_conf_command</literal>. |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
560 </para> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
561 |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
562 <para> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
563 <note> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
564 Следует учитывать, что изменение настроек OpenSSL напрямую |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
565 может привести к неожиданному поведению. |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
566 </note> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
567 </para> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
568 |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
569 </directive> |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
570 |
6684517c9d19
Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2593
diff
changeset
|
571 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
572 <directive name="grpc_ssl_crl"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
573 <syntax><value>файл</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
574 <default/> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
575 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
576 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
577 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
578 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
579 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
580 Указывает <value>файл</value> с отозванными сертификатами (CRL) |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
581 в формате PEM, используемыми при <link id="proxy_ssl_verify">проверке</link> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
582 сертификата gRPC SSL-сервера. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
583 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
584 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
585 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
586 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
587 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
588 <directive name="grpc_ssl_name"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
589 <syntax><value>имя</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
590 <default>имя хоста из grpc_pass</default> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
591 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
592 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
593 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
594 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
595 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
596 Позволяет переопределить имя сервера, используемое при |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
597 <link id="grpc_ssl_verify">проверке</link> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
598 сертификата gRPC SSL-сервера, а также для |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
599 <link id="grpc_ssl_server_name">передачи его через SNI</link> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
600 при установлении соединения с gRPC SSL-сервером. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
601 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
602 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
603 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
604 По умолчанию используется имя хоста из <link id="grpc_pass"/>. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
605 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
606 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
607 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
608 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
609 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
610 <directive name="grpc_ssl_password_file"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
611 <syntax><value>файл</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
612 <default/> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
613 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
614 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
615 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
616 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
617 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
618 Задаёт <value>файл</value> с паролями от |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
619 <link id="grpc_ssl_certificate_key">секретных ключей</link>, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
620 где каждый пароль указан на отдельной строке. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
621 Пароли применяются по очереди в момент загрузки ключа. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
622 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
623 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
624 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
625 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
626 |
2142
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
627 <directive name="grpc_ssl_protocols"> |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
628 <syntax> |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
629 [<literal>SSLv2</literal>] |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
630 [<literal>SSLv3</literal>] |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
631 [<literal>TLSv1</literal>] |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
632 [<literal>TLSv1.1</literal>] |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
633 [<literal>TLSv1.2</literal>] |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
634 [<literal>TLSv1.3</literal>]</syntax> |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
635 <default>TLSv1 TLSv1.1 TLSv1.2</default> |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
636 <context>http</context> |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
637 <context>server</context> |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
638 <context>location</context> |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
639 |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
640 <para> |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
641 Разрешает указанные протоколы для запросов к gRPC SSL-серверу. |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
642 </para> |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
643 |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
644 </directive> |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
645 |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
646 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
647 <directive name="grpc_ssl_server_name"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
648 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
649 <default>off</default> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
650 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
651 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
652 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
653 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
654 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
655 Разрешает или запрещает передачу имени сервера через |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
656 <link url="http://en.wikipedia.org/wiki/Server_Name_Indication">расширение |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
657 Server Name Indication протокола TLS</link> (SNI, RFC 6066) |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
658 при установлении соединения с gRPC SSL-сервером. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
659 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
660 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
661 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
662 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
663 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
664 <directive name="grpc_ssl_session_reuse"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
665 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
666 <default>on</default> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
667 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
668 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
669 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
670 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
671 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
672 Определяет, использовать ли повторно SSL-сессии при |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
673 работе с gRPC-сервером. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
674 Если в логах появляются ошибки |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
675 “<literal>SSL3_GET_FINISHED:digest check failed</literal>”, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
676 то можно попробовать выключить |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
677 повторное использование сессий. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
678 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
679 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
680 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
681 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
682 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
683 <directive name="grpc_ssl_trusted_certificate"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
684 <syntax><value>файл</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
685 <default/> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
686 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
687 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
688 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
689 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
690 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
691 Задаёт <value>файл</value> с доверенными сертификатами CA в формате PEM, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
692 используемыми при <link id="grpc_ssl_verify">проверке</link> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
693 сертификата gRPC SSL-сервера. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
694 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
695 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
696 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
697 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
698 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
699 <directive name="grpc_ssl_verify"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
700 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
701 <default>off</default> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
702 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
703 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
704 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
705 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
706 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
707 Разрешает или запрещает проверку сертификата gRPC SSL-сервера. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
708 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
709 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
710 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
711 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
712 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
713 <directive name="grpc_ssl_verify_depth"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
714 <syntax><value>число</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
715 <default>1</default> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
716 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
717 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
718 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
719 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
720 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
721 Устанавливает глубину проверки в цепочке сертификатов |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
722 gRPC SSL-сервера. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
723 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
724 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
725 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
726 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
727 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
728 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
729 </module> |