Mercurial > hg > nginx-site

annotate xml/ru/docs/stream/ngx_stream_realip_module.xml @ 3011:55d49eb065ac

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Fixed example in the js_periodic directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 14 Sep 2023 16:38:00 +0100
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>