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

annotate xml/ru/docs/http/ngx_http_grpc_module.xml @ 2114:b7dd3e8ee9c2

Documented the gRPC proxy module.

author	Yaroslav Zhuravlev <yar@nginx.com>
date	Fri, 16 Mar 2018 21:46:19 +0300
parents	xml/ru/docs/http/ngx_http_memcached_module.xml@a9a9a052b5bd
children	ca7568f67dee

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"
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	13 rev="1">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	14
110 40eec261c2a6 Added proper support for anonymous sections, notably for the summary. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	15 <section id="summary">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	16
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	17 <para>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	18 Модуль <literal>ngx_http_grpc_module</literal> позволяет передавать запросы
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	19 gRPC-серверу (1.13.10).
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	20 Для работы этого модуля необходим
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	21 модуль <link doc="ngx_http_v2_module.xml">ngx_http_v2_module</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	22 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	23
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	24 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	25
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	26
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	27 <section id="example" name="Пример конфигурации">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	28
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	29 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	30 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	31 server {
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	32 listen 9000 http2;
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	33
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	34 location / {
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	35 grpc_pass 127.0.0.1:9000;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	36 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	37 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	38 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	39 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	40
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	41 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	42
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	43
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	44 <section id="directives" name="Директивы">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	45
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	46 <directive name="grpc_bind">
1885 6839c258c473 Added <literal> tag to proxy bind transparent. Yaroslav Zhuravlev <yar@nginx.com> parents: 1748 diff changeset	47 <syntax>
6839c258c473 Added <literal> tag to proxy bind transparent. Yaroslav Zhuravlev <yar@nginx.com> parents: 1748 diff changeset	48 <value>адрес</value>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	49 [<literal>transparent </literal>] \|
1885 6839c258c473 Added <literal> tag to proxy bind transparent. Yaroslav Zhuravlev <yar@nginx.com> parents: 1748 diff changeset	50 <literal>off</literal></syntax>
772 ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 677 diff changeset	51 <default/>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 677 diff changeset	52 <context>http</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 677 diff changeset	53 <context>server</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 677 diff changeset	54 <context>location</context>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 677 diff changeset	55
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 677 diff changeset	56 <para>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	57 Задаёт локальный IP-адрес с необязательным портом,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	58 который будет использоваться в исходящих соединениях с gRPC-сервером.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	59 В значении параметра допустимо использование переменных.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	60 Специальное значение <literal>off</literal> отменяет действие
815 ed29fd8be462 _bind: variables support and inheritance. Ruslan Ermilov <ru@nginx.com>* parents: 814 diff changeset	61 унаследованной с предыдущего уровня конфигурации
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	62 директивы <literal>grpc_bind</literal>, позволяя системе
1748 be371be7a5c8 Documented optional port for proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1696 diff changeset	63 самостоятельно выбирать локальный IP-адрес и порт.
772 ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 677 diff changeset	64 </para>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 677 diff changeset	65
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	66 <para id="grpc_bind_transparent">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	67 Параметр <literal>transparent</literal> позволяет
1696 d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	68 задать нелокальный IP-aдрес, который будет использоваться в
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	69 исходящих соединениях с gRPC-сервером,
1696 d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	70 например, реальный IP-адрес клиента:
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	71 <example>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	72 grpc_bind $remote_addr transparent;
1696 d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	73 </example>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	74 Для работы параметра
2090 a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	75 обычно требуется
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	76 запустить рабочие процессы nginx с привилегиями
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	77 <link doc="../ngx_core_module.xml" id="user">суперпользователя</link>.
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	78 В Linux этого не требуется, так как если
2090 a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	79 указан параметр <literal>transparent</literal>, то рабочие процессы
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	80 наследуют capability <literal>CAP_NET_RAW</literal> из главного процесса.
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying. Yaroslav Zhuravlev <yar@nginx.com> parents: 1885 diff changeset	81 Также необходимо настроить таблицу маршрутизации ядра
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	82 для перехвата сетевого трафика с gRPC-сервера.
1696 d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	83 </para>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1672 diff changeset	84
772 ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 677 diff changeset	85 </directive>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 677 diff changeset	86
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules. Vladimir Homutov <vl@nginx.com> parents: 677 diff changeset	87
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	88 <directive name="grpc_buffer_size">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	89 <syntax><value>размер</value></syntax>
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	90 <default>4k\|8k</default>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	91 <context>http</context>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	92 <context>server</context>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	93 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	94
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	95 <para>
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	96 Задаёт <value>размер</value> буфера, в который будет читаться ответ,
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	97 получаемый от gRPC-сервера.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	98 Ответ синхронно передаётся клиенту сразу же по мере его поступления.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	99 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	100
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	101 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	102
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	103
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	104 <directive name="grpc_connect_timeout">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	105 <syntax><value>время</value></syntax>
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	106 <default>60s</default>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	107 <context>http</context>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	108 <context>server</context>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	109 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	110
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	111 <para>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	112 Задаёт таймаут для установления соединения с gRPC-сервером.
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	113 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	114 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	115
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	116 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	117
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	118
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	119 <directive name="grpc_hide_header">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	120 <syntax><value>поле</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	121 <default/>
1337 91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	122 <context>http</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	123 <context>server</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	124 <context>location</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	125
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	126 <para>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	127 По умолчанию
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	128 nginx не передаёт клиенту поля заголовка <header>Date</header>,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	129 <header>Server</header> и
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	130 <header>X-Accel-...</header> из ответа gRPC-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	131 Директива <literal>grpc_hide_header</literal> задаёт дополнительные поля,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	132 которые не будут передаваться.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	133 Если же передачу полей нужно разрешить, можно воспользоваться
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	134 директивой <link id="grpc_pass_header"/>.
1337 91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	135 </para>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	136
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	137 </directive>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	138
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends. Yaroslav Zhuravlev <yar@nginx.com> parents: 1290 diff changeset	139
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	140 <directive name="grpc_ignore_headers">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	141 <syntax><value>поле</value> ...</syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	142 <default/>
675 08140f6b7964 Documented gunzip module and corresponding changes. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	143 <context>http</context>
08140f6b7964 Documented gunzip module and corresponding changes. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	144 <context>server</context>
08140f6b7964 Documented gunzip module and corresponding changes. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	145 <context>location</context>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	146
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	147 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	148 Запрещает обработку некоторых полей заголовка из ответа gRPC-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	149 В директиве можно указать поля <header>X-Accel-Redirect</header>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	150 и <header>X-Accel-Charset</header>.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	151 </para>
675 08140f6b7964 Documented gunzip module and corresponding changes. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	152
08140f6b7964 Documented gunzip module and corresponding changes. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	153 <para>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	154 Если не запрещено, обработка этих полей заголовка заключается в следующем:
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	155 <list type="bullet" compact="no">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	156
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	157 <listitem>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	158 <header>X-Accel-Redirect</header> производит
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	159 <link doc="ngx_http_core_module.xml" id="internal">внутреннее
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	160 перенаправление</link> на указанный URI;
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	161 </listitem>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	162
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	163 <listitem>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	164 <header>X-Accel-Charset</header> задаёт желаемую
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	165 <link doc="ngx_http_charset_module.xml" id="charset">кодировку</link>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	166 ответа.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	167 </listitem>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	168
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	169 </list>
675 08140f6b7964 Documented gunzip module and corresponding changes. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	170 </para>
08140f6b7964 Documented gunzip module and corresponding changes. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	171
08140f6b7964 Documented gunzip module and corresponding changes. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	172 </directive>
08140f6b7964 Documented gunzip module and corresponding changes. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	173
08140f6b7964 Documented gunzip module and corresponding changes. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	174
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	175 <directive name="grpc_intercept_errors">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	176 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	177 <default>off</default>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	178 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	179 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	180 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	181
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	182 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	183 Определяет, передавать ли клиенту ответы gRPC-сервера с кодом
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	184 больше либо равным 300,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	185 или же перехватывать их и перенаправлять на обработку nginx’у с помощью
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	186 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	187 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	188
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	189 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	190
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	191
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	192 <directive name="grpc_next_upstream">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	193 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 361 diff changeset	194 <literal>error</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 361 diff changeset	195 <literal>timeout</literal> \|
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	196 <literal>invalid_header</literal> \|
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	197 <literal>http_500</literal> \|
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	198 <literal>http_502</literal> \|
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	199 <literal>http_503</literal> \|
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	200 <literal>http_504</literal> \|
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	201 <literal>http_403</literal> \|
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	202 <literal>http_404</literal> \|
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	203 <literal>http_429</literal> \|
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	204 <literal>non_idempotent</literal> \|
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 361 diff changeset	205 <literal>off</literal>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 361 diff changeset	206 ...</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	207 <default>error timeout</default>
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	208 <context>http</context>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	209 <context>server</context>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	210 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	211
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	212 <para>
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	213 Определяет, в каких случаях запрос будет передан следующему серверу:
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	214 <list type="tag">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	215
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	216 <tag-name><literal>error</literal></tag-name>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	217 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	218 чтения заголовка ответа сервера;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	219
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	220 <tag-name><literal>timeout</literal></tag-name>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	221 <tag-desc>произошёл таймаут во время соединения с сервером,
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	222 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	223
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	224 <tag-name><literal>invalid_header</literal></tag-name>
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	225 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	226
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	227 <tag-name><literal>http_500</literal></tag-name>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	228 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	229
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	230 <tag-name><literal>http_502</literal></tag-name>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	231 <tag-desc>сервер вернул ответ с кодом 502;</tag-desc>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	232
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	233 <tag-name><literal>http_503</literal></tag-name>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	234 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	235
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	236 <tag-name><literal>http_504</literal></tag-name>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	237 <tag-desc>сервер вернул ответ с кодом 504;</tag-desc>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	238
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	239 <tag-name><literal>http_403</literal></tag-name>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	240 <tag-desc>сервер вернул ответ с кодом 403;</tag-desc>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	241
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	242 <tag-name><literal>http_404</literal></tag-name>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	243 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	244
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	245 <tag-name><literal>http_429</literal></tag-name>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	246 <tag-desc>сервер вернул ответ с кодом 429;</tag-desc>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	247
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	248 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	249 <tag-desc>обычно запросы с
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	250 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">неидемпотентным</link>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	251 методом
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	252 (<literal>POST</literal>, <literal>LOCK</literal>, <literal>PATCH</literal>)
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	253 не передаются на другой сервер,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	254 если запрос серверу группы уже был отправлен;
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	255 включение параметра явно разрешает повторять подобные запросы;
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	256 </tag-desc>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	257
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	258
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	259 <tag-name><literal>off</literal></tag-name>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	260 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	261
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	262 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	263 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	264
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	265 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	266 Необходимо понимать, что передача запроса следующему серверу возможна
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	267 только при условии, что клиенту ещё ничего не передавалось.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	268 То есть, если ошибка или таймаут возникли в середине передачи ответа,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	269 то исправить это уже невозможно.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	270 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	271
942 ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 815 diff changeset	272 <para>
1289 57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 1157 diff changeset	273 Директива также определяет, что считается
57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 1157 diff changeset	274 <link doc="ngx_http_upstream_module.xml" id="max_fails">неудачной
57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives. Yaroslav Zhuravlev <yar@nginx.com> parents: 1157 diff changeset	275 попыткой</link> работы с сервером.
942 ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 815 diff changeset	276 Случаи <literal>error</literal>, <literal>timeout</literal> и
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	277 <literal>invalid_header</literal>
942 ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 815 diff changeset	278 всегда считаются неудачными попытками, даже если они не указаны в директиве.
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	279 Случаи <literal>http_500</literal>, <literal>http_502</literal>,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	280 <literal>http_503</literal>, <literal>http_504</literal>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	281 и <literal>http_429</literal>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	282 считаются неудачными попытками, только если они указаны в директиве.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	283 Случаи <literal>http_403</literal> и <literal>http_404</literal>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	284 никогда не считаются неудачными попытками.
942 ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 815 diff changeset	285 </para>
ba3d6ade3513 Elaborate on upstream server failures. Ruslan Ermilov <ru@nginx.com> parents: 815 diff changeset	286
1290 f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	287 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	288 Передача запроса следующему серверу может быть ограничена по
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	289 <link id="grpc_next_upstream_tries">количеству попыток</link>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	290 и по <link id="grpc_next_upstream_timeout">времени</link>.
1290 f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	291 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	292
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	293 </directive>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	294
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	295
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	296 <directive name="grpc_next_upstream_timeout">
1290 f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	297 <syntax><value>время</value></syntax>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	298 <default>0</default>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	299 <context>http</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	300 <context>server</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	301 <context>location</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	302
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	303 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	304 Ограничивает время, в течение которого возможна передача запроса
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	305 <link id="grpc_next_upstream">следующему серверу</link>.
1290 f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	306 Значение <literal>0</literal> отключает это ограничение.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	307 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	308
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	309 </directive>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	310
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	311
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	312 <directive name="grpc_next_upstream_tries">
1290 f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	313 <syntax><value>число</value></syntax>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	314 <default>0</default>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	315 <context>http</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	316 <context>server</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	317 <context>location</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	318
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	319 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	320 Ограничивает число допустимых попыток для передачи запроса
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	321 <link id="grpc_next_upstream">следующему серверу</link>.
1290 f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	322 Значение <literal>0</literal> отключает это ограничение.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	323 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries. Yaroslav Zhuravlev <yar@nginx.com> parents: 1289 diff changeset	324
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	325 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	326
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	327
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	328 <directive name="grpc_pass">
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	329 <syntax><value>адрес</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 76 diff changeset	330 <default/>
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	331 <context>location</context>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	332 <context>if в location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	333
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	334 <para>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	335 Задаёт адрес gRPC-сервера.
1622 c4c1dddfedac Unified _pass address descriptions. Ruslan Ermilov <ru@nginx.com>* parents: 1337 diff changeset	336 Адрес может быть указан в виде доменного имени или IP-адреса,
c4c1dddfedac Unified _pass address descriptions. Ruslan Ermilov <ru@nginx.com>* parents: 1337 diff changeset	337 и порта:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	338 <example>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	339 grpc_pass localhost:9000;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	340 </example>
814 f46a132af596 "memcached_pass" can be a UNIX-domain socket. Ruslan Ermilov <ru@nginx.com> parents: 772 diff changeset	341 или в виде пути UNIX-сокета:
f46a132af596 "memcached_pass" can be a UNIX-domain socket. Ruslan Ermilov <ru@nginx.com> parents: 772 diff changeset	342 <example>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	343 grpc_pass unix:/tmp/grpc.socket;
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	344 </example>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	345 Также может использоваться схема “<literal>grpc://</literal>”:
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	346 <example>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	347 grpc_pass grpc://127.0.0.1:9000;
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	348 </example>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	349 Для использования gRPC по SSL необходимо использовать схему
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	350 “<literal>grpcs://</literal>”:
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	351 <example>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	352 grpc_pass grpcs://127.0.0.1:443;
814 f46a132af596 "memcached_pass" can be a UNIX-domain socket. Ruslan Ermilov <ru@nginx.com> parents: 772 diff changeset	353 </example>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	354 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	355
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	356 <para>
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	357 Если доменному имени соответствует несколько адресов, то все они будут
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	358 использоваться по очереди (round-robin).
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	359 И, кроме того, адрес может быть
135 edf8c90f8085 Renamed ngx_http_upstream to ngx_http_upstream_module. Ruslan Ermilov <ru@nginx.com> parents: 110 diff changeset	360 <link doc="ngx_http_upstream_module.xml">группой серверов</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	361 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	362
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	363 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	364
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	365
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	366 <directive name="grpc_pass_header">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	367 <syntax><value>поле</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	368 <default/>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	369 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	370 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	371 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	372
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	373 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	374 Разрешает передавать от gRPC-сервера клиенту
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	375 <link id="grpc_hide_header">запрещённые для передачи</link> поля заголовка.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	376 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	377
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	378 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	379
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	380
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	381 <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	382 <syntax><value>время</value></syntax>
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	383 <default>60s</default>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	384 <context>http</context>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	385 <context>server</context>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	386 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	387
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	388 <para>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	389 Задаёт таймаут при чтении ответа gRPC-сервера.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	390 Таймаут устанавливается не на всю передачу ответа,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	391 а только между двумя операциями чтения.
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	392 Если по истечении этого времени gRPC-сервер ничего не передаст,
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	393 соединение закрывается.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	394 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	395
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	396 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	397
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	398
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	399 <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	400 <syntax><value>время</value></syntax>
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	401 <default>60s</default>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	402 <context>http</context>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	403 <context>server</context>
1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	404 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	405
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	406 <para>
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	407 Задаёт таймаут при передаче запроса gRPC-серверу.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	408 Таймаут устанавливается не на всю передачу запроса,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	409 а только между двумя операциями записи.
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	410 Если по истечении этого времени gRPC-сервер не примет новых данных,
361 1018108c5068 Revision. Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	411 соединение закрывается.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	412 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	413
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	414 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	415
2114 b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	416
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	417 <directive name="grpc_set_header">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	418 <syntax><value>поле</value> <value>значение</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	419 <default>Content-Length $content_length</default>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	420 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	421 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	422 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	423
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	424 <para>
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 <link id="proxy_pass_request_headers">передаваемые</link> gRPC-серверу.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	427 В качестве значения можно использовать текст, переменные и их комбинации.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	428 Директивы наследуются с предыдущего уровня при условии, что на данном
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	429 уровне не описаны свои директивы <literal>grpc_set_header</literal>.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	430 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	431
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	432 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	433 Если значение поля заголовка — пустая строка, то поле вообще
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	434 не будет передаваться gRPC-серверу:
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	435 <example>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	436 grpc_set_header Accept-Encoding "";
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	437 </example>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	438 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	439
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	440 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	441
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 <directive name="grpc_ssl_certificate">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	444 <syntax><value>файл</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	445 <default/>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	446 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	447 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	448 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	449
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	450 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	451 Задаёт <value>файл</value> с сертификатом в формате PEM
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	452 для аутентификации на gRPC SSL-сервере.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	453 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	454
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	455 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	456
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	457
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	458 <directive name="grpc_ssl_certificate_key">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	459 <syntax><value>файл</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	460 <default/>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	461 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	462 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	463 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	464
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	465 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	466 Задаёт <value>файл</value> с секретным ключом в формате PEM
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	467 для аутентификации на gRPC SSL-сервере.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	468 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	469
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	470 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	471 Вместо <value>файла</value> можно указать значение
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	472 <literal>engine</literal>:<value>имя</value>:<value>id</value>,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	473 которое загружает ключ с указанным <value>id</value>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	474 из OpenSSL engine с заданным <value>именем</value>.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	475 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	476
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	477 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	478
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	479
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	480 <directive name="grpc_ssl_ciphers">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	481 <syntax><value>шифры</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	482 <default>DEFAULT</default>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	483 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	484 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	485 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	486
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	487 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	488 Описывает разрешённые шифры для запросов к gRPC SSL-серверу.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	489 Шифры задаются в формате, поддерживаемом библиотекой OpenSSL.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	490 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	491
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	492 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	493 Полный список можно посмотреть с помощью команды
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	494 “<command>openssl ciphers</command>”.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	495 </para>
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 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	498
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	499
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	500 <directive name="grpc_ssl_crl">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	501 <syntax><value>файл</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	502 <default/>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	503 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	504 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	505 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	506
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 Указывает <value>файл</value> с отозванными сертификатами (CRL)
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	509 в формате PEM, используемыми при <link id="proxy_ssl_verify">проверке</link>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	510 сертификата gRPC SSL-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	511 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	512
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_name">
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>имя хоста из grpc_pass</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 Позволяет переопределить имя сервера, используемое при
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	525 <link id="grpc_ssl_verify">проверке</link>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	526 сертификата gRPC SSL-сервера, а также для
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	527 <link id="grpc_ssl_server_name">передачи его через SNI</link>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	528 при установлении соединения с gRPC SSL-сервером.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	529 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	530
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 По умолчанию используется имя хоста из <link id="grpc_pass"/>.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	533 </para>
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 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	536
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	537
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	538 <directive name="grpc_ssl_password_file">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	539 <syntax><value>файл</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	540 <default/>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	541 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	542 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	543 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	544
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	545 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	546 Задаёт <value>файл</value> с паролями от
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	547 <link id="grpc_ssl_certificate_key">секретных ключей</link>,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	548 где каждый пароль указан на отдельной строке.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	549 Пароли применяются по очереди в момент загрузки ключа.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	550 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	551
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	552 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	553
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	554
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	555 <directive name="grpc_ssl_server_name">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	556 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	557 <default>off</default>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	558 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	559 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	560 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	561
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	562 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	563 Разрешает или запрещает передачу имени сервера через
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	564 <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	565 Server Name Indication протокола TLS</link> (SNI, RFC 6066)
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	566 при установлении соединения с gRPC SSL-сервером.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	567 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	568
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	569 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	570
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	571
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	572 <directive name="grpc_ssl_session_reuse">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	573 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	574 <default>on</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 Определяет, использовать ли повторно SSL-сессии при
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	581 работе с gRPC-сервером.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	582 Если в логах появляются ошибки
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	583 “<literal>SSL3_GET_FINISHED:digest check failed</literal>”,
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 повторное использование сессий.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	586 </para>
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>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	589
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	590
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	591 <directive name="grpc_ssl_protocols">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	592 <syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	593 [<literal>SSLv2</literal>]
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	594 [<literal>SSLv3</literal>]
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	595 [<literal>TLSv1</literal>]
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	596 [<literal>TLSv1.1</literal>]
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	597 [<literal>TLSv1.2</literal>]
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	598 [<literal>TLSv1.3</literal>]</syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	599 <default>TLSv1 TLSv1.1 TLSv1.2</default>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	600 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	601 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	602 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	603
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	604 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	605 Разрешает указанные протоколы для запросов к gRPC SSL-серверу.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	606 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	607
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	608 </directive>
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
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	611 <directive name="grpc_ssl_trusted_certificate">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	612 <syntax><value>файл</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	613 <default/>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	614 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	615 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	616 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	617
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	618 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	619 Задаёт <value>файл</value> с доверенными сертификатами CA в формате PEM,
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	620 используемыми при <link id="grpc_ssl_verify">проверке</link>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	621 сертификата gRPC SSL-сервера.
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
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	627 <directive name="grpc_ssl_verify">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	628 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	629 <default>off</default>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	630 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	631 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	632 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	633
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	634 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	635 Разрешает или запрещает проверку сертификата gRPC SSL-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	636 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	637
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	638 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	639
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	640
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	641 <directive name="grpc_ssl_verify_depth">
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	642 <syntax><value>число</value></syntax>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	643 <default>1</default>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	644 <context>http</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	645 <context>server</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	646 <context>location</context>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	647
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	648 <para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	649 Устанавливает глубину проверки в цепочке сертификатов
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	650 gRPC SSL-сервера.
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	651 </para>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	652
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	653 </directive>
b7dd3e8ee9c2 Documented the gRPC proxy module. Yaroslav Zhuravlev <yar@nginx.com> parents: 2090 diff changeset	654
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	655 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	656
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	657 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_grpc_module.xml @ 2114:b7dd3e8ee9c2