Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_grpc_module.xml @ 2955:2c4d7151b9a9
nginx community slack promo.
author | Maxim Konovalov <maxim@nginx.com> |
---|---|
date | Fri, 28 Apr 2023 09:25:05 -0700 |
parents | 37e082fd009c |
children | cbd963190c15 |
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" |
2948
37e082fd009c
Added TLSv1.3 to the default value of ssl_protocols and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2865
diff
changeset
|
13 rev="9"> |
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"> |
2865
0d355d154181
Corrected syntax of ssl_conf_command and friends.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2837
diff
changeset
|
537 <syntax><value>имя</value> <value>значение</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> |
2948
37e082fd009c
Added TLSv1.3 to the default value of ssl_protocols and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2865
diff
changeset
|
635 <default>TLSv1 TLSv1.1 TLSv1.2 TLSv1.3</default> |
2142
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 |
2948
37e082fd009c
Added TLSv1.3 to the default value of ssl_protocols and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2865
diff
changeset
|
644 <para> |
37e082fd009c
Added TLSv1.3 to the default value of ssl_protocols and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2865
diff
changeset
|
645 <note> |
37e082fd009c
Added TLSv1.3 to the default value of ssl_protocols and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2865
diff
changeset
|
646 Параметр <literal>TLSv1.3</literal> используется по умолчанию |
37e082fd009c
Added TLSv1.3 to the default value of ssl_protocols and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2865
diff
changeset
|
647 начиная с 1.23.4. |
37e082fd009c
Added TLSv1.3 to the default value of ssl_protocols and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2865
diff
changeset
|
648 </note> |
37e082fd009c
Added TLSv1.3 to the default value of ssl_protocols and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2865
diff
changeset
|
649 </para> |
37e082fd009c
Added TLSv1.3 to the default value of ssl_protocols and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2865
diff
changeset
|
650 |
2142
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
651 </directive> |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
652 |
ca7568f67dee
Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents:
2114
diff
changeset
|
653 |
2114
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
654 <directive name="grpc_ssl_server_name"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
655 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
656 <default>off</default> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
657 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
658 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
659 <context>location</context> |
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 <para> |
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 <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
|
664 Server Name Indication протокола TLS</link> (SNI, RFC 6066) |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
665 при установлении соединения с gRPC SSL-сервером. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
666 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
667 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
668 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
669 |
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 <directive name="grpc_ssl_session_reuse"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
672 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
673 <default>on</default> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
674 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
675 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
676 <context>location</context> |
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 Определяет, использовать ли повторно SSL-сессии при |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
680 работе с gRPC-сервером. |
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 “<literal>SSL3_GET_FINISHED:digest check failed</literal>”, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
683 то можно попробовать выключить |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
684 повторное использование сессий. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
685 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
686 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
687 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
688 |
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 <directive name="grpc_ssl_trusted_certificate"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
691 <syntax><value>файл</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
692 <default/> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
693 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
694 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
695 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
696 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
697 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
698 Задаёт <value>файл</value> с доверенными сертификатами CA в формате PEM, |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
699 используемыми при <link id="grpc_ssl_verify">проверке</link> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
700 сертификата gRPC SSL-сервера. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
701 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
702 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
703 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
704 |
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 <directive name="grpc_ssl_verify"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
707 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
708 <default>off</default> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
709 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
710 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
711 <context>location</context> |
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 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
714 Разрешает или запрещает проверку сертификата gRPC SSL-сервера. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
715 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
716 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
717 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
718 |
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 <directive name="grpc_ssl_verify_depth"> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
721 <syntax><value>число</value></syntax> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
722 <default>1</default> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
723 <context>http</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
724 <context>server</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
725 <context>location</context> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
726 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
727 <para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
728 Устанавливает глубину проверки в цепочке сертификатов |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
729 gRPC SSL-сервера. |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
730 </para> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
731 |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
732 </directive> |
b7dd3e8ee9c2
Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
2090
diff
changeset
|
733 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
734 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
735 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
736 </module> |