Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_mirror_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 eeed494bba51
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2016
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
2
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
3 <!--
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
4 Copyright (C) Nginx, Inc.
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
5 -->
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
6
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
8
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
9 <module name="Модуль ngx_http_mirror_module"
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
10 link="/ru/docs/http/ngx_http_mirror_module.html"
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
11 lang="ru"
2593
eeed494bba51 Unified phrases about configuration levels and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 2206
diff changeset
12 rev="4">
2016
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
13
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
14 <section id="summary">
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
15
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
16 <para>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
17 Модуль <literal>ngx_http_mirror_module</literal> (1.13.4) позволяет
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
18 зеркалировать исходный запрос
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
19 при помощи создания фоновых зеркалирующих подзапросов.
2025
1fe9f481d8ce A slight revision of the mirror module.
Ruslan Ermilov <ru@nginx.com>
parents: 2022
diff changeset
20 Ответы на зеркалирующие подзапросы игнорируются.
2016
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
21 </para>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
22
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
23 </section>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
24
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
25
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
26 <section id="example" name="Пример конфигурации">
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
27
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
28 <para>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
29 <example>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
30 location / {
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
31 mirror /mirror;
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
32 proxy_pass http://backend;
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
33 }
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
34
2206
5cacd6fffade Eliminated some examples of unsafe prefix locations.
Ruslan Ermilov <ru@nginx.com>
parents: 2025
diff changeset
35 location = /mirror {
2016
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
36 internal;
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
37 proxy_pass http://test_backend$request_uri;
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
38 }
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
39 </example>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
40 </para>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
41
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
42 </section>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
43
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
44
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
45 <section id="directives" name="Директивы">
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
46
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
47 <directive name="mirror">
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
48 <syntax><value>uri</value> | <literal>off</literal></syntax>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
49 <default>off</default>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
50 <context>http</context>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
51 <context>server</context>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
52 <context>location</context>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
53
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
54 <para>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
55 Задаёт URI, на который будет зеркалироваться исходный запрос.
2593
eeed494bba51 Unified phrases about configuration levels and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 2206
diff changeset
56 На одном уровне конфигурации может быть задано несколько зеркал.
2016
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
57 </para>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
58
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
59 </directive>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
60
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
61
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
62 <directive name="mirror_request_body">
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
63 <syntax><literal>on</literal> | <literal>off</literal></syntax>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
64 <default>on</default>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
65 <context>http</context>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
66 <context>server</context>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
67 <context>location</context>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
68
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
69 <para>
2025
1fe9f481d8ce A slight revision of the mirror module.
Ruslan Ermilov <ru@nginx.com>
parents: 2022
diff changeset
70 Определяет, зеркалировать ли тело запроса клиента.
2016
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
71 Если включено, то тело запроса клиента будет прочитано
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
72 перед созданием зеркалирующих подзапросов.
2025
1fe9f481d8ce A slight revision of the mirror module.
Ruslan Ermilov <ru@nginx.com>
parents: 2022
diff changeset
73 В этом случае небуферизованное проксирование тела запроса клиента,
1fe9f481d8ce A slight revision of the mirror module.
Ruslan Ermilov <ru@nginx.com>
parents: 2022
diff changeset
74 задаваемое директивами
2022
632f7f467e12 Removed redundant text from links.
Ruslan Ermilov <ru@nginx.com>
parents: 2021
diff changeset
75 <link doc="ngx_http_proxy_module.xml" id="proxy_request_buffering"/>,
632f7f467e12 Removed redundant text from links.
Ruslan Ermilov <ru@nginx.com>
parents: 2021
diff changeset
76 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_request_buffering"/>,
632f7f467e12 Removed redundant text from links.
Ruslan Ermilov <ru@nginx.com>
parents: 2021
diff changeset
77 <link doc="ngx_http_scgi_module.xml" id="scgi_request_buffering"/>
2016
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
78 и
2025
1fe9f481d8ce A slight revision of the mirror module.
Ruslan Ermilov <ru@nginx.com>
parents: 2022
diff changeset
79 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_request_buffering"/>,
1fe9f481d8ce A slight revision of the mirror module.
Ruslan Ermilov <ru@nginx.com>
parents: 2022
diff changeset
80 будет отключено.
2016
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
81 <example>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
82 location / {
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
83 mirror /mirror;
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
84 mirror_request_body off;
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
85 proxy_pass http://backend;
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
86 }
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
87
2206
5cacd6fffade Eliminated some examples of unsafe prefix locations.
Ruslan Ermilov <ru@nginx.com>
parents: 2025
diff changeset
88 location = /mirror {
2016
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
89 internal;
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
90 proxy_pass http://log_backend;
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
91 proxy_pass_request_body off;
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
92 proxy_set_header Content-Length "";
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
93 proxy_set_header X-Original-URI $request_uri;
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
94 }
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
95 </example>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
96 </para>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
97
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
98 </directive>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
99
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
100 </section>
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
101
e6de97d14f81 Documented the mirror module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
102 </module>