Mercurial > hg > nginx-site

annotate xml/ru/docs/stream/ngx_stream_realip_module.xml @ 2769:16f6fa718be2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated TLSv1.3 support notes. Previous notes described some early development snapshot of OpenSSL 1.1.1 with disabled TLSv1.3 by default. It was then enabled in the first alpha. Further, the updated text covers later major releases such as OpenSSL 3.0.
author Sergey Kandaurov <pluknet@nginx.com>
date Thu, 30 Sep 2021 16:29:20 +0300
parents ee56773d44e8
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
bfe3eff81d04 Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents: 110
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: 523
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
4 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
5 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
6
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8
1779
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
9 <module name="Модуль ngx_stream_realip_module"
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
10 link="/ru/docs/stream/ngx_stream_realip_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
11 lang="ru"
1779
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
12 rev="1">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
13
110
40eec261c2a6 Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
14 <section id="summary">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
15
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
16 <para>
1779
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
17 Модуль <literal>ngx_stream_realip_module</literal> позволяет
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
18 менять адрес и порт клиента
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
19 на переданные в заголовке протокола PROXY (1.11.4).
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
20 Протокол PROXY должен быть предварительно включён при помощи установки
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
21 параметра <link doc="ngx_stream_core_module.xml" id="proxy_protocol"/>
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
22 в директиве <literal>listen</literal>.
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
23 </para>
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
24
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
25 <para>
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
26 По умолчанию этот модуль не собирается, его сборку необходимо
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
27 разрешить с помощью конфигурационного параметра
1779
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
28 <literal>--with-stream_realip_module</literal>.
76
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
31 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
32
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
33
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
34 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
35
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
36 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37 <example>
1779
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
38 listen 12345 proxy_protocol;
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
39
518
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 468
diff changeset
40 set_real_ip_from 192.168.1.0/24;
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 468
diff changeset
41 set_real_ip_from 192.168.2.1;
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 468
diff changeset
42 set_real_ip_from 2001:0db8::/32;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
45
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
46 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
47
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
48
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
49 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
50
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
51 <directive name="set_real_ip_from">
468
31e81dcc4ffd set_real_ip_from: documented the special parameter "unix:".
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
52 <syntax>
31e81dcc4ffd set_real_ip_from: documented the special parameter "unix:".
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
53 <value>адрес</value> |
31e81dcc4ffd set_real_ip_from: documented the special parameter "unix:".
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
54 <value>CIDR</value> |
31e81dcc4ffd set_real_ip_from: documented the special parameter "unix:".
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
55 <literal>unix:</literal></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 76
diff changeset
56 <default/>
1779
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
57 <context>stream</context>
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
58 <context>server</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
59
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
60 <para>
518
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 468
diff changeset
61 Задаёт доверенные адреса, которые передают верный адрес
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
62 для замены.
468
31e81dcc4ffd set_real_ip_from: documented the special parameter "unix:".
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
63 Если указано специальное значение <literal>unix:</literal>,
31e81dcc4ffd set_real_ip_from: documented the special parameter "unix:".
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
64 доверенными будут считаться все UNIX-сокеты.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
65 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
66
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
67 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
68
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
69 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
70
1601
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
71
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
72 <section id="variables" name="Встроенные переменные">
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
73
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
74 <para>
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
75 <list type="tag">
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
76
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
77 <tag-name id="var_realip_remote_addr"><var>$realip_remote_addr</var></tag-name>
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
78 <tag-desc>
1779
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
79 хранит исходный адрес клиента
1601
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
80 </tag-desc>
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
81
1705
f855acbd0a94 Documented the $realip_remote_port variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1602
diff changeset
82 <tag-name id="var_realip_remote_port"><var>$realip_remote_port</var></tag-name>
f855acbd0a94 Documented the $realip_remote_port variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1602
diff changeset
83 <tag-desc>
1779
ee56773d44e8 Documented ngx_stream_realip_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1705
diff changeset
84 хранит исходный порт клиента
1705
f855acbd0a94 Documented the $realip_remote_port variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1602
diff changeset
85 </tag-desc>
f855acbd0a94 Documented the $realip_remote_port variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1602
diff changeset
86
1601
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
87 </list>
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
88 </para>
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
89
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
90 </section>
8854618e1ca5 Documented the "$realip_remote_addr" variable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1523
diff changeset
91
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
92 </module>