comparison xml/ru/docs/http/ngx_http_proxy_protocol_vendor_module.xml @ 2915:923977f02d39

Updated docs for the upcoming NGINX Plus release.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 29 Nov 2022 11:48:55 +0000
parents
children
comparison
equal deleted inserted replaced
2914:3a2d342533fb 2915:923977f02d39
1 <?xml version="1.0"?>
2
3 <!--
4 Copyright (C) Nginx, Inc.
5 -->
6
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8
9 <module name="Модуль ngx_http_proxy_protocol_vendor_module"
10 link="/ru/docs/http/ngx_http_proxy_protocol_vendor_module.html"
11 lang="ru"
12 rev="1">
13
14 <section id="summary">
15
16 <para>
17 Модуль <literal>ngx_http_proxy_protocol_vendor_module</literal> (1.23.3)
18 позволяет получать дополнительную информацию о соединении из
19 облачных платформ при помощи TLV, полученных из
20 заголовка
21 <link url="http://www.haproxy.org/download/1.8/doc/proxy-protocol.txt">протокола
22 PROXY</link>.
23 </para>
24
25 <para>
26 Поддерживаемые облачные платформы:
27 <list type="bullet">
28
29 <listitem>
30 Amazon Web Services
31 </listitem>
32
33 <listitem>
34 Google Cloud Platform
35 </listitem>
36
37 <listitem>
38 Microsoft Azure
39 </listitem>
40
41 </list>
42 </para>
43
44 <para>
45 Протокол PROXY должен быть предварительно включён при помощи установки
46 параметра <literal>proxy_protocol</literal> в директиве
47 <link doc="ngx_http_core_module.xml" id="listen"/>.
48 </para>
49
50 <para>
51 <note>
52 Модуль доступен как часть
53 <commercial_version>коммерческой подписки</commercial_version>
54 </note>
55 </para>
56
57 </section>
58
59
60 <section id="example" name="Пример конфигурации">
61
62 <para>
63 <example>
64 proxy_set_header X-Conn-ID $proxy_protocol_tlv_gcp_conn_id;
65
66 server {
67 listen 80 proxy_protocol;
68 listen 443 ssl proxy_protocol;
69 ...
70 }
71 </example>
72 </para>
73
74 </section>
75
76
77 <section id="variables" name="Встроенные переменные">
78
79 <para>
80 <list type="tag">
81
82 <tag-name id="var_proxy_protocol_tlv_aws_vpce_id"><var>$proxy_protocol_tlv_aws_vpce_id</var></tag-name>
83 <tag-desc>
84 значение TLV, полученное из заголовка протокола PROXY, содержащее
85 <link url="https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html#proxy-protocol">ID
86 конечной точки VPC AWS</link>
87 </tag-desc>
88
89 <tag-name id="var_proxy_protocol_tlv_azure_pel_id"><var>$proxy_protocol_tlv_azure_pel_id</var></tag-name>
90 <tag-desc>
91 значение TLV, полученное из заголовка протокола PROXY, содержащее
92 <link url="https://learn.microsoft.com/en-us/azure/private-link/private-link-service-overview#getting-connection-information-using-tcp-proxy-v2">LinkID
93 частной конечной точки Azure</link>
94 </tag-desc>
95
96 <tag-name id="var_proxy_protocol_tlv_gcp_conn_id"><var>$proxy_protocol_tlv_gcp_conn_id</var></tag-name>
97 <tag-desc>
98 значение TLV, полученное из заголовка протокола PROXY, содержащее
99 <link url="https://cloud.google.com/vpc/docs/configure-private-service-connect-producer#proxy-protocol">ID соединения
100 Google Cloud PSC</link>
101 </tag-desc>
102
103 </list>
104 </para>
105
106 </section>
107
108 </module>