Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_gunzip_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 ac709e45740d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
676
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
2
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
3 <!--
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
4 Copyright (C) Maxim Dounin
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
5 Copyright (C) Nginx, Inc.
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
6 -->
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
7
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
9
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
10 <module name="Модуль ngx_http_gunzip_module"
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_gunzip_module.html"
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
12 lang="ru"
744
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
13 rev="2">
676
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
14
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
15 <section id="summary">
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
16
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
17 <para>
744
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
18 Модуль <literal>ngx_http_gunzip_module</literal> — это фильтр,
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
19 распаковывающий ответы с “<literal>Content-Encoding: gzip</literal>”
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
20 для тех клиентов, которые не поддерживают метод сжатия “gzip”.
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
21 Модуль будет полезен, когда данные желательно хранить сжатыми
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
22 для экономии места и сокращения затрат на ввод-вывод.
676
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
23 </para>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
24
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
25 <para>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
26 По умолчанию этот модуль не собирается, его сборку необходимо
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
27 разрешить с помощью конфигурационного параметра
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
28 <literal>--with-http_gunzip_module</literal>.
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
29 </para>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
30
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
31 </section>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
32
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
33
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
34 <section id="example" name="Пример конфигурации">
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
35
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
36 <para>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
37 <example>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
38 location /storage/ {
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
39 gunzip on;
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
40 ...
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
41 }
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
42 </example>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
43 </para>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
44
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
45 </section>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
46
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
47
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
48 <section id="directives" name="Директивы">
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
49
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
50 <directive name="gunzip">
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
51 <syntax><literal>on</literal> | <literal>off</literal></syntax>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
52 <default>off</default>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
53 <context>http</context>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
54 <context>server</context>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
55 <context>location</context>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
56
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
57 <para>
744
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
58 Разрешает или запрещает распаковку ответов, сжатых методом gzip,
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
59 для тех клиентов, которые его не поддерживают.
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
60 Если разрешено, то для определения, поддерживает ли клиент gzip,
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
61 также учитываются следующие директивы:
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
62 <link doc="ngx_http_gzip_module.xml" id="gzip_http_version"/>,
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
63 <link doc="ngx_http_gzip_module.xml" id="gzip_proxied"/> и
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
64 <link doc="ngx_http_gzip_module.xml" id="gzip_disable"/>.
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
65 См. также директиву <link doc="ngx_http_gzip_module.xml" id="gzip_vary"/>.
676
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
66 </para>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
67
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
68 </directive>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
69
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
70
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
71 <directive name="gunzip_buffers">
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
72 <syntax><value>число</value> <value>размер</value></syntax>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
73 <default>32 4k|16 8k</default>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
74 <context>http</context>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
75 <context>server</context>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
76 <context>location</context>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
77
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
78 <para>
744
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
79 Задаёт <value>число</value> и <value>размер</value> буферов,
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
80 в которые будет разжиматься ответ.
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
81 По умолчанию размер одного буфера равен размеру страницы.
ac709e45740d Revision of ngx_http_gunzip_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents: 676
diff changeset
82 В зависимости от платформы это или 4K, или 8K.
676
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
83 </para>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
84
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
85 </directive>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
86
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
87 </section>
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
88
6d6aa03e43fa Actually added gunzip module documentation files.
Vladimir Homutov <vl@nginx.com>
parents:
diff changeset
89 </module>