nginx-site: xml/ru/docs/http/ngx_http_grpc

annotate xml/ru/docs/http/ngx_http_grpc_module.xml @ 2948:37e082fd009c

Added TLSv1.3 to the default value of ssl_protocols and friends.

author	Yaroslav Zhuravlev <yar@nginx.com>
date	Fri, 10 Mar 2023 22:17:07 +0000
parents	0d355d154181
children	cbd963190c15

rev	line source
222 bfe3eff81d04 Removed redundant encoding specification. Ruslan Ermilov <ru@nginx.com> parents: 135 diff changeset	1 <?xml version="1.0"?>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2
580 be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	3 <!--
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	6 -->
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	7
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	9
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	10 <module name="Модуль ngx_http_grpc_module"
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	11 link="/ru/docs/http/ngx_http_grpc_module.html"
589 764fbac1b8b4 Added document revision. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	12 lang="ru"
2948 37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	13 rev="9">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	14
110 40eec261c2a6 Added proper support for anonymous sections, notably for the summary. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	15 <section id="summary">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	16
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	17 <para>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	18 Модуль <literal>ngx_http_grpc_module</literal> позволяет передавать запросы
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	19 gRPC-серверу (1.13.10).
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	20 Для работы этого модуля необходим
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	21 модуль <link doc="ngx_http_v2_module.xml">ngx_http_v2_module</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	22 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	23
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	24 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	25
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	26
361 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>обычно запросы с
2831 4add6ae1296f Updated links to datatracker.ietf.org. Sergey Kandaurov <pluknet@nginx.com> parents: 2721 diff changeset	250 <link url="https://datatracker.ietf.org/doc/html/rfc7231#section-4.2.2">неидемпотентным</link>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	251 методом
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	252 (<literal>POST</literal>, <literal>LOCK</literal>, <literal>PATCH</literal>)
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	253 не передаются на другой сервер,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	254 если запрос серверу группы уже был отправлен;
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	255 включение параметра явно разрешает повторять подобные запросы;
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	256 </tag-desc>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	257
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	258
361 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">
2865 0d355d154181 Corrected syntax of ssl_conf_command and friends. Sergey Kandaurov <pluknet@nginx.com> parents: 2837 diff changeset	537 <syntax><value>имя</value> <value>значение</value></syntax>
2617 6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	538 <default/>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	539 <context>http</context>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	540 <context>server</context>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	541 <context>location</context>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	542 <appeared-in>1.19.4</appeared-in>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	543
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	544 <para>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	545 Задаёт произвольные конфигурационные
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	546 <link url="https://www.openssl.org/docs/man1.1.1/man3/SSL_CONF_cmd.html">команды</link>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	547 OpenSSL
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	548 при установлении соединения с gRPC SSL-сервером.
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	549 <note>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	550 Директива поддерживается при использовании OpenSSL 1.0.2 и выше.
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	551 </note>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	552 </para>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	553
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	554 <para>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	555 На одном уровне может быть указано
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	556 несколько директив <literal>grpc_ssl_conf_command</literal>.
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	557 Директивы наследуются с предыдущего уровня конфигурации при условии, что
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	558 на данном уровне не описаны
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	559 свои директивы <literal>grpc_ssl_conf_command</literal>.
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	560 </para>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	561
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	562 <para>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	563 <note>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	564 Следует учитывать, что изменение настроек OpenSSL напрямую
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	565 может привести к неожиданному поведению.
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	566 </note>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	567 </para>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	568
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	569 </directive>
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	570
6684517c9d19 Documented the proxy_ssl_conf_command directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2593 diff changeset	571
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	572 <directive name="grpc_ssl_crl">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	573 <syntax><value>файл</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	574 <default/>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	575 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	576 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	577 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	578
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	579 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	580 Указывает <value>файл</value> с отозванными сертификатами (CRL)
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	581 в формате PEM, используемыми при <link id="proxy_ssl_verify">проверке</link>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	582 сертификата gRPC SSL-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	583 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	584
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	585 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	586
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	587
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	588 <directive name="grpc_ssl_name">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	589 <syntax><value>имя</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	590 <default>имя хоста из grpc_pass</default>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	591 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	592 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	593 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	594
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	595 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	596 Позволяет переопределить имя сервера, используемое при
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	597 <link id="grpc_ssl_verify">проверке</link>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	598 сертификата gRPC SSL-сервера, а также для
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	599 <link id="grpc_ssl_server_name">передачи его через SNI</link>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	600 при установлении соединения с gRPC SSL-сервером.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	601 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	602
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	603 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	604 По умолчанию используется имя хоста из <link id="grpc_pass"/>.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	605 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	606
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	607 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	608
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	609
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	610 <directive name="grpc_ssl_password_file">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	611 <syntax><value>файл</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	612 <default/>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	613 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	614 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	615 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	616
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	617 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	618 Задаёт <value>файл</value> с паролями от
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	619 <link id="grpc_ssl_certificate_key">секретных ключей</link>,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	620 где каждый пароль указан на отдельной строке.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	621 Пароли применяются по очереди в момент загрузки ключа.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	622 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	623
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	624 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	625
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	626
2142 ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	627 <directive name="grpc_ssl_protocols">
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	628 <syntax>
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	629 [<literal>SSLv2</literal>]
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	630 [<literal>SSLv3</literal>]
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	631 [<literal>TLSv1</literal>]
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	632 [<literal>TLSv1.1</literal>]
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	633 [<literal>TLSv1.2</literal>]
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	634 [<literal>TLSv1.3</literal>]</syntax>
2948 37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	635 <default>TLSv1 TLSv1.1 TLSv1.2 TLSv1.3</default>
2142 ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	636 <context>http</context>
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	637 <context>server</context>
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	638 <context>location</context>
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	639
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	640 <para>
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	641 Разрешает указанные протоколы для запросов к gRPC SSL-серверу.
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	642 </para>
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	643
2948 37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	644 <para>
37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	645 <note>
37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	646 Параметр <literal>TLSv1.3</literal> используется по умолчанию
37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	647 начиная с 1.23.4.
37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	648 </note>
37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	649 </para>
37e082fd009c Added TLSv1.3 to the default value of ssl_protocols and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 2865 diff changeset	650
2142 ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	651 </directive>
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	652
ca7568f67dee Sorted directives alphabetically. Ruslan Ermilov <ru@nginx.com> parents: 2114 diff changeset	653
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	654 <directive name="grpc_ssl_server_name">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	655 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	656 <default>off</default>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	657 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	658 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	659 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	660
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	661 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	662 Разрешает или запрещает передачу имени сервера через
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	663 <link url="http://en.wikipedia.org/wiki/Server_Name_Indication">расширение
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	664 Server Name Indication протокола TLS</link> (SNI, RFC 6066)
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	665 при установлении соединения с gRPC SSL-сервером.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	666 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	667
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	668 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	669
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	670
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	671 <directive name="grpc_ssl_session_reuse">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	672 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	673 <default>on</default>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	674 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	675 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	676 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	677
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	678 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	679 Определяет, использовать ли повторно SSL-сессии при
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	680 работе с gRPC-сервером.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	681 Если в логах появляются ошибки
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	682 “<literal>SSL3_GET_FINISHED:digest check failed</literal>”,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	683 то можно попробовать выключить
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	684 повторное использование сессий.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	685 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	686
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	687 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	688
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	689
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	690 <directive name="grpc_ssl_trusted_certificate">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	691 <syntax><value>файл</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	692 <default/>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	693 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	694 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	695 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	696
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	697 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	698 Задаёт <value>файл</value> с доверенными сертификатами CA в формате PEM,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	699 используемыми при <link id="grpc_ssl_verify">проверке</link>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	700 сертификата gRPC SSL-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	701 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	702
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	703 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	704
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	705
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	706 <directive name="grpc_ssl_verify">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	707 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	708 <default>off</default>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	709 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	710 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	711 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	712
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	713 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	714 Разрешает или запрещает проверку сертификата gRPC SSL-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	715 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	716
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	717 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	718
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	719
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	720 <directive name="grpc_ssl_verify_depth">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	721 <syntax><value>число</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	722 <default>1</default>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	723 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	724 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	725 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	726
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	727 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	728 Устанавливает глубину проверки в цепочке сертификатов
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	729 gRPC SSL-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	730 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	731
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	732 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	733
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	734 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	735
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	736 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_grpc_module.xml @ 2948:37e082fd009c