annotate xml/ru/docs/http/ngx_http_grpc_module.xml @ 2769:16f6fa718be2

Updated TLSv1.3 support notes. Previous notes described some early development snapshot of OpenSSL 1.1.1 with disabled TLSv1.3 by default. It was then enabled in the first alpha. Further, the updated text covers later major releases such as OpenSSL 3.0.
author Sergey Kandaurov <pluknet@nginx.com>
date Thu, 30 Sep 2021 16:29:20 +0300
parents 7041bddec07d
children 4add6ae1296f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="ru"
2721
7041bddec07d Documented variables support for certificates in proxy, uwsgi, grpc.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2617
diff changeset
13 rev="6">
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
90 <default>4k|8k</default>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
91 <context>http</context>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
92 <context>server</context>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
106 <default>60s</default>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
107 <context>http</context>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
108 <context>server</context>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
193 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 361
diff changeset
194 <literal>error</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 361
diff changeset
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
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 361
diff changeset
205 <literal>off</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 361
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
208 <context>http</context>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
209 <context>server</context>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
213 Определяет, в каких случаях запрос будет передан следующему серверу:
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
214 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
215
361
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
216 <tag-name><literal>error</literal></tag-name>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
217 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
218 чтения заголовка ответа сервера;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
219
361
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
220 <tag-name><literal>timeout</literal></tag-name>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
221 <tag-desc>произошёл таймаут во время соединения с сервером,
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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>обычно запросы с
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
250 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">неидемпотентным</link>
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
259 <tag-name><literal>off</literal></tag-name>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
331 <context>location</context>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
357 Если доменному имени соответствует несколько адресов, то все они будут
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
358 использоваться по очереди (round-robin).
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
392 <default>60s</default>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
393 <context>http</context>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
394 <context>server</context>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
410 <default>60s</default>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
411 <context>http</context>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
412 <context>server</context>
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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
1018108c5068 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
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">
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
537 <syntax><value>command</value></syntax>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
538 <default/>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
539 <context>http</context>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
540 <context>server</context>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
541 <context>location</context>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
542 <appeared-in>1.19.4</appeared-in>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
543
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
544 <para>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
545 Задаёт произвольные конфигурационные
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
546 <link url="https://www.openssl.org/docs/man1.1.1/man3/SSL_CONF_cmd.html">команды</link>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
547 OpenSSL
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
548 при установлении соединения с gRPC SSL-сервером.
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
549 <note>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
550 Директива поддерживается при использовании OpenSSL 1.0.2 и выше.
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
551 </note>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
552 </para>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
553
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
554 <para>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
555 На одном уровне может быть указано
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
556 несколько директив <literal>grpc_ssl_conf_command</literal>.
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
557 Директивы наследуются с предыдущего уровня конфигурации при условии, что
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
558 на данном уровне не описаны
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
559 свои директивы <literal>grpc_ssl_conf_command</literal>.
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
560 </para>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
561
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
562 <para>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
563 <note>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
564 Следует учитывать, что изменение настроек OpenSSL напрямую
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
565 может привести к неожиданному поведению.
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
566 </note>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
567 </para>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
568
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
569 </directive>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
570
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2593
diff changeset
571
2114
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
572 <directive name="grpc_ssl_crl">
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
573 <syntax><value>файл</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
574 <default/>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
575 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
576 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
577 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
578
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
579 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
580 Указывает <value>файл</value> с отозванными сертификатами (CRL)
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
581 в формате PEM, используемыми при <link id="proxy_ssl_verify">проверке</link>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
582 сертификата gRPC SSL-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
583 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
584
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
585 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
586
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
587
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
588 <directive name="grpc_ssl_name">
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
589 <syntax><value>имя</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
590 <default>имя хоста из grpc_pass</default>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
591 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
592 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
593 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
594
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
595 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
596 Позволяет переопределить имя сервера, используемое при
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
597 <link id="grpc_ssl_verify">проверке</link>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
598 сертификата gRPC SSL-сервера, а также для
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
599 <link id="grpc_ssl_server_name">передачи его через SNI</link>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
600 при установлении соединения с gRPC SSL-сервером.
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
601 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
602
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
603 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
604 По умолчанию используется имя хоста из <link id="grpc_pass"/>.
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
605 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
606
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
607 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
608
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
609
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
610 <directive name="grpc_ssl_password_file">
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
611 <syntax><value>файл</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
612 <default/>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
613 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
614 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
615 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
616
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
617 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
618 Задаёт <value>файл</value> с паролями от
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
619 <link id="grpc_ssl_certificate_key">секретных ключей</link>,
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
620 где каждый пароль указан на отдельной строке.
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
621 Пароли применяются по очереди в момент загрузки ключа.
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
622 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
623
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
624 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
625
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
626
2142
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
627 <directive name="grpc_ssl_protocols">
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
628 <syntax>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
629 [<literal>SSLv2</literal>]
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
630 [<literal>SSLv3</literal>]
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
631 [<literal>TLSv1</literal>]
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
632 [<literal>TLSv1.1</literal>]
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
633 [<literal>TLSv1.2</literal>]
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
634 [<literal>TLSv1.3</literal>]</syntax>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
635 <default>TLSv1 TLSv1.1 TLSv1.2</default>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
636 <context>http</context>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
637 <context>server</context>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
638 <context>location</context>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
639
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
640 <para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
641 Разрешает указанные протоколы для запросов к gRPC SSL-серверу.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
642 </para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
643
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
644 </directive>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
645
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2114
diff changeset
646
2114
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
647 <directive name="grpc_ssl_server_name">
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
648 <syntax><literal>on</literal> | <literal>off</literal></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
649 <default>off</default>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
650 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
651 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
652 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
653
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
654 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
655 Разрешает или запрещает передачу имени сервера через
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
656 <link url="http://en.wikipedia.org/wiki/Server_Name_Indication">расширение
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
657 Server Name Indication протокола TLS</link> (SNI, RFC 6066)
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
658 при установлении соединения с gRPC SSL-сервером.
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
659 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
660
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
661 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
662
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
663
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
664 <directive name="grpc_ssl_session_reuse">
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
665 <syntax><literal>on</literal> | <literal>off</literal></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
666 <default>on</default>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
667 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
668 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
669 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
670
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
671 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
672 Определяет, использовать ли повторно SSL-сессии при
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
673 работе с gRPC-сервером.
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
674 Если в логах появляются ошибки
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
675 “<literal>SSL3_GET_FINISHED:digest check failed</literal>”,
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
676 то можно попробовать выключить
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
677 повторное использование сессий.
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
678 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
679
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
680 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
681
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
682
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
683 <directive name="grpc_ssl_trusted_certificate">
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
684 <syntax><value>файл</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
685 <default/>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
686 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
687 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
688 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
689
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
690 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
691 Задаёт <value>файл</value> с доверенными сертификатами CA в формате PEM,
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
692 используемыми при <link id="grpc_ssl_verify">проверке</link>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
693 сертификата gRPC SSL-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
694 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
695
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
696 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
697
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
698
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
699 <directive name="grpc_ssl_verify">
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
700 <syntax><literal>on</literal> | <literal>off</literal></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
701 <default>off</default>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
702 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
703 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
704 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
705
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
706 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
707 Разрешает или запрещает проверку сертификата gRPC SSL-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
708 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
709
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
710 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
711
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
712
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
713 <directive name="grpc_ssl_verify_depth">
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
714 <syntax><value>число</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
715 <default>1</default>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
716 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
717 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
718 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
719
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
720 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
721 Устанавливает глубину проверки в цепочке сертификатов
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
722 gRPC SSL-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
723 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
724
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
725 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
726
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
727 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
728
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
729 </module>