annotate xml/ru/docs/http/ngx_http_uwsgi_module.xml @ 2254:d765ffffd08c

Documented proxy_socket_keepalive and friends.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 09 Oct 2018 19:56:33 +0300
parents a9a9a052b5bd
children a5bbfdf88bbd
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
2
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
3 <!--
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
4 Copyright (C) Igor Sysoev
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
5 Copyright (C) Nginx, Inc.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
6 -->
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
7
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
9
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
10 <module name="Модуль ngx_http_uwsgi_module"
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_uwsgi_module.html"
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
12 lang="ru"
2254
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
13 rev="43">
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
14
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
15 <section id="summary">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
16
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
17 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
18 Модуль <literal>ngx_http_uwsgi_module</literal> позволяет передавать
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
19 запросы uwsgi-серверу.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
20 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
21
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
22 </section>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
23
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
24
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
25 <section id="example" name="Пример конфигурации">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
26
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
27 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
28 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
29 location / {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
30 include uwsgi_params;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
31 uwsgi_pass localhost:9000;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
32 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
33 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
34 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
35
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
36 </section>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
37
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
38
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
39 <section id="directives" name="Директивы">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
40
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
41 <directive name="uwsgi_bind">
1885
6839c258c473 Added <literal> tag to proxy bind transparent.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1838
diff changeset
42 <syntax>
6839c258c473 Added <literal> tag to proxy bind transparent.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1838
diff changeset
43 <value>адрес</value>
6839c258c473 Added <literal> tag to proxy bind transparent.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1838
diff changeset
44 [<literal>transparent</literal>] |
6839c258c473 Added <literal> tag to proxy bind transparent.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1838
diff changeset
45 <literal>off</literal></syntax>
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
46 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
47 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
48 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
49 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
50
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
51 <para>
1748
be371be7a5c8 Documented optional port for proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1724
diff changeset
52 Задаёт локальный IP-адрес с необязательным портом (1.11.2),
be371be7a5c8 Documented optional port for proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1724
diff changeset
53 который будет использоваться в исходящих соединениях с uwsgi-сервером.
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
54 В значении параметра допустимо использование переменных (1.3.12).
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
55 Специальное значение <literal>off</literal> (1.3.12) отменяет действие
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
56 унаследованной с предыдущего уровня конфигурации
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
57 директивы <literal>uwsgi_bind</literal>, позволяя системе
1748
be371be7a5c8 Documented optional port for proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1724
diff changeset
58 самостоятельно выбирать локальный IP-адрес и порт.
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
59 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
60
1696
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
61 <para id="uwsgi_bind_transparent">
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
62 Параметр <literal>transparent</literal> (1.11.0) позволяет
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
63 задать нелокальный IP-aдрес, который будет использоваться в
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
64 исходящих соединениях с uwsgi-сервером,
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
65 например, реальный IP-адрес клиента:
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
66 <example>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
67 uwsgi_bind $remote_addr transparent;
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
68 </example>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
69 Для работы параметра
2090
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
70 обычно требуется
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
71 запустить рабочие процессы nginx с привилегиями
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
72 <link doc="../ngx_core_module.xml" id="user">суперпользователя</link>.
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
73 В Linux этого не требуется (1.13.8), так как если
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
74 указан параметр <literal>transparent</literal>, то рабочие процессы
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
75 наследуют capability <literal>CAP_NET_RAW</literal> из главного процесса.
a9a9a052b5bd Documented the "CAP_NET_RAW" capability for transparent proxying.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2069
diff changeset
76 Также необходимо настроить таблицу маршрутизации ядра
1696
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
77 для перехвата сетевого трафика с uwsgi-сервера.
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
78 </para>
d855e7cc3b2f Added the "transparent" parameter of proxy_bind and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1672
diff changeset
79
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
80 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
81
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
82
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
83 <directive name="uwsgi_buffer_size">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
84 <syntax><value>размер</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
85 <default>4k|8k</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
86 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
87 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
88 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
89
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
90 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
91 Задаёт <value>размер</value> буфера, в который будет читаться
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
92 первая часть ответа, получаемого от uwsgi-сервера.
1550
305f2c338181 Fixed description of default value of proxy_buffer_size and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1542
diff changeset
93 По умолчанию размер одного буфера равен размеру страницы памяти.
305f2c338181 Fixed description of default value of proxy_buffer_size and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1542
diff changeset
94 В зависимости от платформы это или 4K, или 8K,
305f2c338181 Fixed description of default value of proxy_buffer_size and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1542
diff changeset
95 однако его можно сделать меньше.
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
96 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
97
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
98 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
99
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
100
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
101 <directive name="uwsgi_buffering">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
102 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
103 <default>on</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
104 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
105 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
106 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
107
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
108 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
109 Разрешает или запрещает использовать буферизацию ответов uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
110 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
111
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
112 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
113 Если буферизация включена, то nginx принимает ответ uwsgi-сервера
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
114 как можно быстрее, сохраняя его в буферы, заданные директивами
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
115 <link id="uwsgi_buffer_size"/> и <link id="uwsgi_buffers"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
116 Если ответ не вмещается целиком в память, то его часть может быть записана
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
117 на диск во <link id="uwsgi_temp_path">временный файл</link>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
118 Запись во временные файлы контролируется директивами
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
119 <link id="uwsgi_max_temp_file_size"/> и
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
120 <link id="uwsgi_temp_file_write_size"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
121 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
122
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
123 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
124 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
125 по мере его поступления.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
126 nginx не пытается считать весь ответ uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
127 Максимальный размер данных, который nginx может принять от сервера
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
128 за один раз, задаётся директивой <link id="uwsgi_buffer_size"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
129 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
130
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
131 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
132 Буферизация может быть также включена или выключена путём передачи
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
133 значения “<literal>yes</literal>” или “<literal>no</literal>” в поле
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
134 <header>X-Accel-Buffering</header> заголовка ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
135 Эту возможность можно запретить с помощью директивы
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
136 <link id="uwsgi_ignore_headers"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
137 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
138
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
139 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
140
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
141
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
142 <directive name="uwsgi_buffers">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
143 <syntax><value>число</value> <value>размер</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
144 <default>8 4k|8k</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
145 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
146 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
147 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
148
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
149 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
150 Задаёт <value>число</value> и <value>размер</value> буферов
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
151 для одного соединения,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
152 в которые будет читаться ответ, получаемый от uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
153 По умолчанию размер одного буфера равен размеру страницы.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
154 В зависимости от платформы это или 4K, или 8K.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
155 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
156
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
157 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
158
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
159
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
160 <directive name="uwsgi_busy_buffers_size">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
161 <syntax><value>размер</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
162 <default>8k|16k</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
163 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
164 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
165 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
166
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
167 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
168 При включённой <link id="uwsgi_buffering">буферизации</link> ответов
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
169 uwsgi-сервера, ограничивает суммарный <value>размер</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
170 буферов, которые могут быть заняты для отправки ответа клиенту, пока
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
171 ответ ещё не прочитан целиком.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
172 Оставшиеся буферы тем временем могут использоваться для чтения ответа
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
173 и, при необходимости, буферизации части ответа во временный файл.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
174 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
175 директивами <link id="uwsgi_buffer_size"/> и <link id="uwsgi_buffers"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
176 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
177
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
178 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
179
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
180
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
181 <directive name="uwsgi_cache">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
182 <syntax><value>зона</value> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
183 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
184 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
185 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
186 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
187
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
188 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
189 Задаёт зону разделяемой памяти, используемой для кэширования.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
190 Одна и та же зона может использоваться в нескольких местах.
1382
94cac978bda3 Documented variables support in proxy_cache and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1379
diff changeset
191 В значении параметра можно использовать переменные (1.7.9).
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
192 Параметр <literal>off</literal> запрещает кэширование, унаследованное
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
193 с предыдущего уровня конфигурации.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
194 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
195
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
196 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
197
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
198
1909
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
199 <directive name="uwsgi_cache_background_update">
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
200 <syntax><literal>on</literal> | <literal>off</literal></syntax>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
201 <default>off</default>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
202 <context>http</context>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
203 <context>server</context>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
204 <context>location</context>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
205 <appeared-in>1.11.10</appeared-in>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
206
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
207 <para>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
208 Позволяет запустить фоновый подзапрос
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
209 для обновления просроченного элемента кэша,
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
210 в то время как клиенту возвращается устаревший закэшированный ответ.
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
211 Использование устаревшего закэшированного ответа в момент его обновления
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
212 должно быть
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
213 <link id="uwsgi_cache_use_stale_updating">разрешено</link>.
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
214 </para>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
215
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
216 </directive>
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
217
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
218
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
219 <directive name="uwsgi_cache_bypass">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
220 <syntax><value>строка</value> ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
221 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
222 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
223 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
224 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
225
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
226 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
227 Задаёт условия, при которых ответ не будет браться из кэша.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
228 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
229 то ответ не берётся из кэша:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
230 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
231 uwsgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
232 uwsgi_cache_bypass $http_pragma $http_authorization;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
233 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
234 Можно использовать совместно с директивой <link id="uwsgi_no_cache"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
235 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
236
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
237 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
238
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
239
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
240 <directive name="uwsgi_cache_key">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
241 <syntax><value>строка</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
242 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
243 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
244 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
245 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
246
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
247 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
248 Задаёт ключ для кэширования, например,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
249 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
250 uwsgi_cache_key localhost:9000$request_uri;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
251 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
252 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
253
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
254 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
255
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
256
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
257 <directive name="uwsgi_cache_lock">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
258 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
259 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
260 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
261 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
262 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
263 <appeared-in>1.1.12</appeared-in>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
264
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
265 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
266 Если включено, одновременно только одному запросу будет позволено
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
267 заполнить новый элемент кэша, идентифицируемый согласно директиве
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
268 <link id="uwsgi_cache_key"/>, передав запрос на uwsgi-сервер.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
269 Остальные запросы этого же элемента будут либо ожидать
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
270 появления ответа в кэше, либо освобождения блокировки
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
271 этого элемента, в течение времени, заданного директивой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
272 <link id="uwsgi_cache_lock_timeout"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
273 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
274
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
275 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
276
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
277
1379
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
278 <directive name="uwsgi_cache_lock_age">
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
279 <syntax><value>время</value></syntax>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
280 <default>5s</default>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
281 <context>http</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
282 <context>server</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
283 <context>location</context>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
284 <appeared-in>1.7.8</appeared-in>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
285
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
286 <para>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
287 Если последний запрос, переданный на uwsgi-сервер
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
288 для заполнения нового элемента кэша,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
289 не завершился за указанное <value>время</value>,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
290 на uwsgi-сервер может быть передан ещё один запрос.
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
291 </para>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
292
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
293 </directive>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
294
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
295
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
296 <directive name="uwsgi_cache_lock_timeout">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
297 <syntax><value>время</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
298 <default>5s</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
299 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
300 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
301 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
302 <appeared-in>1.1.12</appeared-in>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
303
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
304 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
305 Задаёт таймаут для <link id="uwsgi_cache_lock"/>.
1379
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
306 По истечении указанного <value>времени</value>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
307 запрос будет передан на uwsgi-сервер,
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
308 однако ответ не будет закэширован.
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
309 <note>
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
310 До версии 1.7.8 такой ответ мог быть закэширован.
91f5c089f4ca Documented fastcgi_cache_lock_age and look-alikes.
Ruslan Ermilov <ru@nginx.com>
parents: 1372
diff changeset
311 </note>
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
312 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
313
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
314 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
315
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
316
1838
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
317 <directive name="uwsgi_cache_max_range_offset">
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
318 <syntax><value>число</value></syntax>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
319 <default/>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
320 <context>http</context>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
321 <context>server</context>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
322 <context>location</context>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
323 <appeared-in>1.11.6</appeared-in>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
324
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
325 <para>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
326 Задаёт смещение в байтах для запросов с указанием диапазона запрашиваемых байт
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
327 (byte-range requests).
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
328 Если диапазон находится за указанным смещением,
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
329 range-запрос будет передан на uwsgi-сервер
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
330 и ответ не будет закэширован.
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
331 </para>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
332
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
333 </directive>
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
334
0d6ac4838921 Documented proxy_cache_max_range_offset and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1810
diff changeset
335
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
336 <directive name="uwsgi_cache_methods">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
337 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
338 <literal>GET</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
339 <literal>HEAD</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
340 <literal>POST</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
341 ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
342 <default>GET HEAD</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
343 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
344 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
345 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
346
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
347 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
348 Если метод запроса клиента указан в этой директиве,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
349 то ответ будет закэширован.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
350 Методы “<literal>GET</literal>” и “<literal>HEAD</literal>” всегда добавляются
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
351 в список, но тем не менее рекомендуется перечислять их явно.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
352 См. также директиву <link id="uwsgi_no_cache"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
353 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
354
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
355 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
356
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
357
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
358 <directive name="uwsgi_cache_min_uses">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
359 <syntax><value>число</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
360 <default>1</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
361 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
362 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
363 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
364
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
365 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
366 Задаёт <value>число</value> запросов, после которого ответ будет закэширован.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
367 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
368
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
369 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
370
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
371
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
372 <directive name="uwsgi_cache_path">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
373 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
374 <value>путь</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
375 [<literal>levels</literal>=<value>уровни</value>]
1384
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
376 [<literal>use_temp_path</literal>=<literal>on</literal>|<literal>off</literal>]
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
377 <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
378 [<literal>inactive</literal>=<value>время</value>]
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
379 [<literal>max_size</literal>=<value>размер</value>]
1810
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
380 [<literal>manager_files</literal>=<value>число</value>]
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
381 [<literal>manager_sleep</literal>=<value>время</value>]
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
382 [<literal>manager_threshold</literal>=<value>время</value>]
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
383 [<literal>loader_files</literal>=<value>число</value>]
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
384 [<literal>loader_sleep</literal>=<value>время</value>]
1582
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
385 [<literal>loader_threshold</literal>=<value>время</value>]
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
386 [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
387 [<literal>purger_files</literal>=<value>число</value>]
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
388 [<literal>purger_sleep</literal>=<value>время</value>]
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
389 [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
390 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
391 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
392
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
393 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
394 Задаёт путь и другие параметры кэша.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
395 Данные кэша хранятся в файлах.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
396 Именем файла в кэше является результат функции MD5
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
397 от <link id="uwsgi_cache_key">ключа кэширования</link>.
1796
1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1748
diff changeset
398 Параметр <literal>levels</literal> задаёт уровни иерархии кэша:
1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1748
diff changeset
399 можно задать от 1 до 3 уровней, на каждом уровне допускаются значения 1 или 2.
1d576e8d6ead Clarified the "levels" parameter of proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1748
diff changeset
400 Например, при использовании
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
401 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
402 uwsgi_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
403 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
404 имена файлов в кэше будут такого вида:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
405 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
406 /data/nginx/cache/<emphasis>c</emphasis>/<emphasis>29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
407 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
408 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
409
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
410 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
411 Кэшируемый ответ сначала записывается во временный файл, а потом этот файл
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
412 переименовывается.
1724
ce3e89d13fa0 Removed unneeded comma in "Since ..." Russian constructs.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1696
diff changeset
413 Начиная с версии 0.8.9 временные файлы и кэш
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
414 могут располагаться на разных файловых системах.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
415 Однако нужно учитывать,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
416 что в этом случае вместо дешёвой операции переименовывания в пределах
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
417 одной файловой системы файл копируется с одной файловой системы на другую.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
418 Поэтому лучше, если кэш будет находиться на той же файловой
1384
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
419 системе, что и каталог с временными файлами.
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
420 Какой из каталогов будет использоваться для временных файлов
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
421 определяется параметром <literal>use_temp_path</literal> (1.7.10).
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
422 Если параметр не задан или установлен в значение “<literal>on</literal>”,
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
423 то будет использоваться каталог, задаваемый директивой
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
424 <link id="uwsgi_temp_path"/> для данного location.
1384
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
425 Если параметр установлен в значение “<literal>off</literal>”,
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
426 то временные файлы будут располагаться непосредственно в каталоге кэша.
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
427 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
428
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
429 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
430 Кроме того, все активные ключи и информация о данных хранятся в зоне
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
431 разделяемой памяти, <value>имя</value> и <value>размер</value> которой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
432 задаются параметром <literal>keys_zone</literal>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
433 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей.
2069
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
434 <note>
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
435 Как часть
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
436 <commercial_version>коммерческой подписки</commercial_version>
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
437 в зоне разделяемой памяти также хранится расширенная
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
438 <link doc="ngx_http_api_module.xml" id="http_caches_">информация</link> о кэше,
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
439 поэтому для хранения аналогичного количества ключей необходимо указывать
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
440 больший размер зоны.
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
441 Например
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
442 зоны размером в 1 мегабайт достаточно для хранения около 4 тысяч ключей.
fc3ba2e76974 Documented size of keys_zone for commercial version (trac #1286).
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1991
diff changeset
443 </note>
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
444 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
445
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
446 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
447 Если к данным кэша не обращаются в течение времени, заданного параметром
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
448 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
449 По умолчанию <literal>inactive</literal> равен 10 минутам.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
450 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
451
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
452 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
453 Специальный процесс “cache manager” следит за максимальным размером кэша,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
454 заданным параметром <literal>max_size</literal>, и при превышении
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
455 его размеров удаляет наименее востребованные данные.
1810
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
456 Удаление данных происходит итерациями, настраиваемыми параметрами (1.11.5)
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
457 <literal>manager_files</literal>,
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
458 <literal>manager_threshold</literal> и
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
459 <literal>manager_sleep</literal>.
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
460 За одну итерацию загружается не более <literal>manager_files</literal>
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
461 элементов (по умолчанию 100).
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
462 Время работы одной итерации ограничено параметром
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
463 <literal>manager_threshold</literal> (по умолчанию 200 миллисекунд).
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
464 Между итерациями делается пауза на время, заданное параметром
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
465 <literal>manager_sleep</literal> (по умолчанию 50 миллисекунд).
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
466 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
467
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
468 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
469 Через минуту после старта активируется специальный процесс “cache loader”,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
470 который загружает в зону кэша информацию о ранее закэшированных данных,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
471 хранящихся на файловой системе.
1810
bc6341aaa832 Added cache manager parameters to proxy_cache path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1804
diff changeset
472 Загрузка также происходит итерациями.
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
473 За одну итерацию загружается не более <literal>loader_files</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
474 элементов (по умолчанию 100).
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
475 Кроме того, время работы одной итерации ограничено параметром
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
476 <literal>loader_threshold</literal> (по умолчанию 200 миллисекунд).
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
477 Между итерациями делается пауза на время, заданное параметром
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
478 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
479 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
480
1582
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
481 <para>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
482 Кроме того,
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
483 следующие параметры доступны как часть
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
484 <commercial_version>коммерческой подписки</commercial_version>:
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
485 </para>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
486
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
487 <para>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
488 <list type="tag">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
489
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
490 <tag-name id="purger">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
491 <literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
492 </tag-name>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
493 <tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
494 Указывает, будут ли записи в кэше, соответствующие
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
495 <link id="uwsgi_cache_purge">маске</link>,
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
496 удалены с диска при помощи процесса “cache purger” (1.7.12).
1659
680cbf783efe Fixed some misuses of "value".
Ruslan Ermilov <ru@nginx.com>
parents: 1622
diff changeset
497 Установка параметра в значение <literal>on</literal>
680cbf783efe Fixed some misuses of "value".
Ruslan Ermilov <ru@nginx.com>
parents: 1622
diff changeset
498 (по умолчанию <literal>off</literal>)
1582
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
499 активирует процесс “cache purger”, который
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
500 проходит по всем записям в кэше
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
501 и удаляет записи, соответствующие этой маске.
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
502 </tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
503
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
504 <tag-name id="purger_files">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
505 <literal>purger_files</literal>=<value>число</value>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
506 </tag-name>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
507 <tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
508 Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
509 По умолчанию <literal>purger_files</literal> равен 10.
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
510 </tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
511
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
512 <tag-name id="purger_threshold">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
513 <literal>purger_threshold</literal>=<value>время</value>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
514 </tag-name>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
515 <tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
516 Задаёт продолжительность одной итерации (1.7.12).
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
517 По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
518 </tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
519
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
520 <tag-name id="purger_sleep">
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
521 <literal>purger_sleep</literal>=<value>время</value>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
522 </tag-name>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
523 <tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
524 Задаёт паузу между итерациями (1.7.12).
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
525 По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
526 </tag-desc>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
527
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
528 </list>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
529 </para>
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
530
1973
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
531 <para>
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
532 <note>
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
533 В версиях 1.7.3, 1.7.7 и 1.11.10 формат заголовка кэша был изменён.
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
534 При обновлении на более новую версию nginx
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
535 ранее закэшированные ответы будут считаться недействительными.
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
536 </note>
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
537 </para>
3460bd328287 Documented cache version change in proxy_cache_path and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1956
diff changeset
538
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
539 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
540
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
541
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
542 <directive name="uwsgi_cache_purge">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
543 <syntax>строка ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
544 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
545 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
546 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
547 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
548 <appeared-in>1.5.7</appeared-in>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
549
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
550 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
551 Задаёт условия, при которых запрос будет считаться запросом
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
552 на очистку кэша.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
553 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
554 то запись в кэше с соответствующим
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
555 <link id="uwsgi_cache_key">ключом кэширования</link> удаляется.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
556 В результате успешной операции возвращается ответ с кодом
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
557 <http-status code="204" text="No Content"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
558 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
559
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
560 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
561 Если <link id="uwsgi_cache_key">ключ кэширования</link>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
562 запроса на очистку заканчивается
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
563 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
564 этой маске, будут удалены из кэша.
1582
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
565 Тем не менее, эти записи будут оставаться на диске или до момента удаления
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
566 из-за <link id="uwsgi_cache_path">отсутствия обращения к данным</link>,
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
567 или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
8973c7b37854 Updated commercial docs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1550
diff changeset
568 или до попытки клиента получить к ним доступ.
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
569 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
570
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
571 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
572 Пример конфигурации:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
573 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
574 uwsgi_cache_path /data/nginx/cache keys_zone=cache_zone:10m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
575
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
576 map $request_method $purge_method {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
577 PURGE 1;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
578 default 0;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
579 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
580
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
581 server {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
582 ...
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
583 location / {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
584 uwsgi_pass http://backend;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
585 uwsgi_cache cache_zone;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
586 uwsgi_cache_key $uri;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
587 uwsgi_cache_purge $purge_method;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
588 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
589 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
590 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
591 <note>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
592 Функциональность доступна как часть
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
593 <commercial_version>коммерческой подписки</commercial_version>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
594 </note>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
595 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
596
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
597 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
598
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
599
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
600 <directive name="uwsgi_cache_revalidate">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
601 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
602 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
603 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
604 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
605 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
606 <appeared-in>1.5.7</appeared-in>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
607
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
608 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
609 Разрешает ревалидацию просроченных элементов кэша при помощи
1246
5be7716a5684 Documented If-None-Match in proxy_cache_revalidate and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1199
diff changeset
610 условных запросов с полями заголовка
5be7716a5684 Documented If-None-Match in proxy_cache_revalidate and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1199
diff changeset
611 <header>If-Modified-Since</header> и <header>If-None-Match</header>.
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
612 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
613
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
614 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
615
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
616
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
617 <directive name="uwsgi_cache_use_stale">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
618 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
619 <literal>error</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
620 <literal>timeout</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
621 <literal>invalid_header</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
622 <literal>updating</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
623 <literal>http_500</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
624 <literal>http_503</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
625 <literal>http_403</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
626 <literal>http_404</literal> |
1956
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
627 <literal>http_429</literal> |
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
628 <literal>off</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
629 ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
630 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
631 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
632 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
633 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
634
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
635 <para>
1910
41cf2c2d8c5c Cache: support for stale-while-revalidate and stale-if-error.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1909
diff changeset
636 Определяет, в каких случаях можно использовать устаревший закэшированный ответ.
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
637 Параметры директивы совпадают с параметрами
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
638 директивы <link id="uwsgi_next_upstream"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
639 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
640
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
641 <para>
1542
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1499
diff changeset
642 Параметр <literal>error</literal> также позволяет использовать
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1499
diff changeset
643 устаревший закэшированный ответ при невозможности выбора
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1499
diff changeset
644 uwsgi-сервера для обработки запроса.
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1499
diff changeset
645 </para>
a13a99cf46ea Better documented "*_cache_use_stale error".
Ruslan Ermilov <ru@nginx.com>
parents: 1499
diff changeset
646
1909
399d0e188195 Documented proxy_cache_background_update and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1885
diff changeset
647 <para id="uwsgi_cache_use_stale_updating">
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
648 Кроме того, дополнительный параметр <literal>updating</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
649 разрешает использовать устаревший закэшированный ответ,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
650 если на данный момент он уже обновляется.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
651 Это позволяет минимизировать число обращений к uwsgi-серверам
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
652 при обновлении закэшированных данных.
1912
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
653 </para>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
654
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
655 <para>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
656 Использование устаревшего закэшированного ответа
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
657 может также быть разрешено непосредственно в заголовке ответа
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
658 на определённое количество секунд после того, как ответ устарел (1.11.10).
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
659 Такой способ менее приоритетен, чем задание параметров директивы.
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
660 <list type="bullet" compact="no">
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
661
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
662 <listitem>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
663 Расширение
1910
41cf2c2d8c5c Cache: support for stale-while-revalidate and stale-if-error.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1909
diff changeset
664 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>”
1912
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
665 поля заголовка <header>Cache-Control</header> разрешает
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
666 использовать устаревший закэшированный ответ,
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
667 если на данный момент он уже обновляется.
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
668 </listitem>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
669
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
670 <listitem>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
671 Расширение
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
672 “<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>”
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
673 поля заголовка <header>Cache-Control</header> разрешает
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
674 использовать устаревший закэшированный ответ в случае ошибки.
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
675 </listitem>
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
676
ec4af97e4403 Split off header options from parameters in proxy_cache_use_stale and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1910
diff changeset
677 </list>
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
678 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
679
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
680 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
681 Чтобы минимизировать число обращений к uwsgi-серверам при
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
682 заполнении нового элемента кэша, можно воспользоваться директивой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
683 <link id="uwsgi_cache_lock"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
684 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
685
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
686 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
687
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
688
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
689 <directive name="uwsgi_cache_valid">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
690 <syntax>[<value>код</value> ...] <value>время</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
691 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
692 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
693 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
694 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
695
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
696 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
697 Задаёт время кэширования для разных кодов ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
698 Например, директивы
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
699 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
700 uwsgi_cache_valid 200 302 10m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
701 uwsgi_cache_valid 404 1m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
702 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
703 задают время кэширования 10 минут для ответов с кодами 200 и 302
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
704 и 1 минуту для ответов с кодом 404.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
705 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
706
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
707 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
708 Если указано только <value>время</value> кэширования,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
709 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
710 uwsgi_cache_valid 5m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
711 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
712 то кэшируются только ответы 200, 301 и 302.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
713 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
714
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
715 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
716 Кроме того, можно кэшировать любые ответы с помощью параметра
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
717 <literal>any</literal>:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
718 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
719 uwsgi_cache_valid 200 302 10m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
720 uwsgi_cache_valid 301 1h;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
721 uwsgi_cache_valid any 1m;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
722 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
723 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
724
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
725 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
726 Параметры кэширования могут также быть заданы непосредственно
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
727 в заголовке ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
728 Такой способ приоритетнее, чем задание времени кэширования с помощью директивы.
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
729 <list type="bullet" compact="no">
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
730
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
731 <listitem>
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
732 Поле заголовка <header>X-Accel-Expires</header> задаёт время кэширования
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
733 ответа в секундах.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
734 Значение 0 запрещает кэшировать ответ.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
735 Если значение начинается с префикса <literal>@</literal>, оно задаёт абсолютное
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
736 время в секундах с начала эпохи, до которого ответ может быть закэширован.
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
737 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
738
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
739 <listitem>
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
740 Если в заголовке нет поля <header>X-Accel-Expires</header>,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
741 параметры кэширования определяются по полям заголовка
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
742 <header>Expires</header> или <header>Cache-Control</header>.
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
743 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
744
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
745 <listitem>
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
746 Ответ, в заголовке которого есть поле <header>Set-Cookie</header>,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
747 не будет кэшироваться.
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
748 </listitem>
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
749
1353
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
750 <listitem>
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
751 Ответ, в заголовке которого есть поле <header>Vary</header>
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
752 со специальным значением “<literal>*</literal>”,
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
753 не будет кэшироваться (1.7.7).
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
754 Ответ, в заголовке которого есть поле <header>Vary</header>
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
755 с другим значением, будет закэширован
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
756 с учётом соответствующих полей заголовка запроса (1.7.7).
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
757 </listitem>
25db29c8875e Documented how the "Vary" response header field affects caching.
Ruslan Ermilov <ru@nginx.com>
parents: 1352
diff changeset
758
1349
97c8b146cb0e Split the long paragraph about caching parameters into the list.
Ruslan Ermilov <ru@nginx.com>
parents: 1345
diff changeset
759 </list>
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
760 Обработка одного или более из этих полей заголовка может быть отключена
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
761 при помощи директивы <link id="uwsgi_ignore_headers"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
762 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
763
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
764 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
765
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
766
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
767 <directive name="uwsgi_connect_timeout">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
768 <syntax><value>время</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
769 <default>60s</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
770 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
771 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
772 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
773
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
774 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
775 Задаёт таймаут для установления соединения с uwsgi-сервером.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
776 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
777 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
778
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
779 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
780
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
781
1337
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
782 <directive name="uwsgi_force_ranges">
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
783 <syntax><literal>on</literal> | <literal>off</literal></syntax>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
784 <default>off</default>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
785 <context>http</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
786 <context>server</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
787 <context>location</context>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
788 <appeared-in>1.7.7</appeared-in>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
789
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
790 <para>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
791 Включает поддержку диапазонов запрашиваемых байт (byte-range)
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
792 для кэшированных и некэшированных ответов uwsgi-сервера
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
793 вне зависимости от наличия поля <header>Accept-Ranges</header>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
794 в заголовках этих ответов.
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
795 </para>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
796
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
797 </directive>
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
798
91a064bdb4f9 Documented the "proxy_force_ranges" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1290
diff changeset
799
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
800 <directive name="uwsgi_hide_header">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
801 <syntax><value>поле</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
802 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
803 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
804 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
805 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
806
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
807 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
808 По умолчанию
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
809 nginx не передаёт клиенту поля заголовка <header>Status</header> и
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
810 <header>X-Accel-...</header> из ответа uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
811 Директива <literal>uwsgi_hide_header</literal> задаёт дополнительные поля,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
812 которые не будут передаваться.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
813 Если же передачу полей нужно разрешить, можно воспользоваться
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
814 директивой <link id="uwsgi_pass_header"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
815 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
816
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
817 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
818
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
819
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
820 <directive name="uwsgi_ignore_client_abort">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
821 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
822 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
823 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
824 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
825 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
826
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
827 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
828 Определяет, закрывать ли соединение с uwsgi-сервером
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
829 в случае, если клиент закрыл соединение, не дождавшись ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
830 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
831
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
832 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
833
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
834
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
835 <directive name="uwsgi_ignore_headers">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
836 <syntax><value>поле</value> ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
837 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
838 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
839 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
840 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
841
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
842 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
843 Запрещает обработку некоторых полей заголовка из ответа uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
844 В директиве можно указать поля <header>X-Accel-Redirect</header>,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
845 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6),
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
846 <header>X-Accel-Buffering</header> (1.1.6),
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
847 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
1345
da296387cdac Documented the Vary support in proxy_ignore_headers and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1343
diff changeset
848 <header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44)
da296387cdac Documented the Vary support in proxy_ignore_headers and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1343
diff changeset
849 и <header>Vary</header> (1.7.7).
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
850 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
851
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
852 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
853 Если не запрещено, обработка этих полей заголовка заключается в следующем:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
854 <list type="bullet" compact="no">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
855
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
856 <listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
857 <header>X-Accel-Expires</header>, <header>Expires</header>,
1345
da296387cdac Documented the Vary support in proxy_ignore_headers and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1343
diff changeset
858 <header>Cache-Control</header>, <header>Set-Cookie</header>
da296387cdac Documented the Vary support in proxy_ignore_headers and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1343
diff changeset
859 и <header>Vary</header>
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
860 задают параметры <link id="uwsgi_cache_valid">кэширования</link> ответа;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
861 </listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
862
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
863 <listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
864 <header>X-Accel-Redirect</header> производит
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
865 <link doc="ngx_http_core_module.xml" id="internal">внутреннее
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
866 перенаправление</link> на указанный URI;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
867 </listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
868
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
869 <listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
870 <header>X-Accel-Limit-Rate</header> задаёт
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
871 <link doc="ngx_http_core_module.xml" id="limit_rate">ограничение
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
872 скорости</link> передачи ответа клиенту;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
873 </listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
874
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
875 <listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
876 <header>X-Accel-Buffering</header> включает или выключает
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
877 <link id="uwsgi_buffering">буферизацию</link> ответа;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
878 </listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
879
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
880 <listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
881 <header>X-Accel-Charset</header> задаёт желаемую
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
882 <link doc="ngx_http_charset_module.xml" id="charset">кодировку</link>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
883 ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
884 </listitem>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
885
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
886 </list>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
887 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
888
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
889 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
890
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
891
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
892 <directive name="uwsgi_intercept_errors">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
893 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
894 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
895 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
896 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
897 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
898
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
899 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
900 Определяет, передавать ли клиенту ответы uwsgi-сервера с кодом
1803
621d0c682113 Clarified description of proxy_intercept_errors and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1796
diff changeset
901 больше либо равным 300,
1804
d655cfd46c26 Corrected Russian translation of proxy_intercept_errors and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1803
diff changeset
902 или же перехватывать их и перенаправлять на обработку nginx’у с помощью
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
903 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
904 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
905
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
906 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
907
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
908
1342
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
909 <directive name="uwsgi_limit_rate">
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
910 <syntax><value>скорость</value></syntax>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
911 <default>0</default>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
912 <context>http</context>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
913 <context>server</context>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
914 <context>location</context>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
915 <appeared-in>1.7.7</appeared-in>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
916
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
917 <para>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
918 Ограничивает скорость чтения ответа от uwsgi-сервера.
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
919 <value>Скорость</value> задаётся в байтах в секунду.
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
920 Значение 0 отключает ограничение скорости.
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
921 Ограничение устанавливается на запрос,
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
922 поэтому, если nginx одновременно
1343
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
923 откроет два соединения к uwsgi-серверу,
1bdde28e359b Fixed fallouts from the previous change.
Ruslan Ermilov <ru@nginx.com>
parents: 1342
diff changeset
924 суммарная скорость будет вдвое выше заданного ограничения.
1342
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
925 Ограничение работает только в случае, если включена
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
926 <link id="uwsgi_buffering">буферизация</link> ответов uwsgi-сервера.
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
927 </para>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
928
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
929 </directive>
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
930
758fc0b02651 Documented the "proxy_limit_rate" directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1337
diff changeset
931
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
932 <directive name="uwsgi_max_temp_file_size">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
933 <syntax><value>размер</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
934 <default>1024m</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
935 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
936 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
937 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
938
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
939 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
940 Если включена <link id="uwsgi_buffering">буферизация</link> ответов
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
941 uwsgi-сервера, и ответ не вмещается целиком в буферы,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
942 заданные директивами <link id="uwsgi_buffer_size"/> и
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
943 <link id="uwsgi_buffers"/>, часть ответа может быть записана во временный файл.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
944 Эта директива задаёт максимальный <value>размер</value> временного файла.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
945 Размер данных, сбрасываемых во временный файл за один раз, задаётся
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
946 директивой <link id="uwsgi_temp_file_write_size"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
947 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
948
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
949 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
950 Значение 0 отключает возможность буферизации ответов во временные файлы.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
951 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
952
1352
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
953 <para>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
954 <note>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
955 Данное ограничение не распространяется на ответы,
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
956 которые будут <link id="uwsgi_cache">закэшированы</link>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
957 или <link id="uwsgi_store">сохранены</link> на диске.
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
958 </note>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
959 </para>
dbb618f60a54 Elaborate on writing proxied responses to files.
Ruslan Ermilov <ru@nginx.com>
parents: 1349
diff changeset
960
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
961 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
962
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
963
1199
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
964 <directive name="uwsgi_modifier1">
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
965 <syntax><value>число</value></syntax>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
966 <default>0</default>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
967 <context>http</context>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
968 <context>server</context>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
969 <context>location</context>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
970
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
971 <para>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
972 Задаёт значение поля <literal>modifier1</literal> в
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
973 <link url="http://uwsgi-docs.readthedocs.org/en/latest/Protocol.html#uwsgi-packet-header">заголовке
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
974 пакета uwsgi</link>.
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
975 </para>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
976 </directive>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
977
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
978
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
979 <directive name="uwsgi_modifier2">
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
980 <syntax><value>число</value></syntax>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
981 <default>0</default>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
982 <context>http</context>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
983 <context>server</context>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
984 <context>location</context>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
985
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
986 <para>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
987 Задаёт значение поля <literal>modifier2</literal> в
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
988 <link url="http://uwsgi-docs.readthedocs.org/en/latest/Protocol.html#uwsgi-packet-header">заголовке
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
989 пакета uwsgi</link>.
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
990 </para>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
991 </directive>
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
992
5ee8a00f2bc5 Documented the uwsgi_modifier1 and uwsgi_modifier2 directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1193
diff changeset
993
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
994 <directive name="uwsgi_next_upstream">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
995 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
996 <literal>error</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
997 <literal>timeout</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
998 <literal>invalid_header</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
999 <literal>http_500</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1000 <literal>http_503</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1001 <literal>http_403</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1002 <literal>http_404</literal> |
1956
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
1003 <literal>http_429</literal> |
1669
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1004 <literal>non_idempotent</literal> |
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1005 <literal>off</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1006 ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1007 <default>error timeout</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1008 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1009 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1010 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1011
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1012 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1013 Определяет, в каких случаях запрос будет передан следующему серверу:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1014 <list type="tag">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1015
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1016 <tag-name><literal>error</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1017 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1018 чтения заголовка ответа сервера;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1019
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1020 <tag-name><literal>timeout</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1021 <tag-desc>произошёл таймаут во время соединения с сервером,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1022 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1023
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1024 <tag-name><literal>invalid_header</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1025 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1026
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1027 <tag-name><literal>http_500</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1028 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1029
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1030 <tag-name><literal>http_503</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1031 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1032
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1033 <tag-name><literal>http_403</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1034 <tag-desc>сервер вернул ответ с кодом 403;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1035
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1036 <tag-name><literal>http_404</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1037 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1038
1956
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
1039 <tag-name><literal>http_429</literal></tag-name>
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
1040 <tag-desc>сервер вернул ответ с кодом 429 (1.11.13);</tag-desc>
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
1041
1669
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1042 <tag-name id="non_idempotent"><literal>non_idempotent</literal></tag-name>
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1043 <tag-desc>обычно запросы с
1923
66a30a380fba Fixed links to tools.ietf.org.
Ruslan Ermilov <ru@nginx.com>
parents: 1912
diff changeset
1044 <link url="https://tools.ietf.org/html/rfc7231#section-4.2.2">неидемпотентным</link>
1669
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1045 методом
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1046 (<literal>POST</literal>, <literal>LOCK</literal>, <literal>PATCH</literal>)
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1047 не передаются на другой сервер,
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1048 если запрос серверу группы уже был отправлен (1.9.13);
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1049 включение параметра явно разрешает повторять подобные запросы;
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1050 </tag-desc>
c872b93682f4 Added "non_idempotent" for proxy_next_upstream and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1659
diff changeset
1051
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1052 <tag-name><literal>off</literal></tag-name>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1053 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1054
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1055 </list>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1056 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1057
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1058 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1059 Необходимо понимать, что передача запроса следующему серверу возможна
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1060 только при условии, что клиенту ещё ничего не передавалось.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1061 То есть, если ошибка или таймаут возникли в середине передачи ответа,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1062 то исправить это уже невозможно.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1063 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1064
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1065 <para>
1289
57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1246
diff changeset
1066 Директива также определяет, что считается
57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1246
diff changeset
1067 <link doc="ngx_http_upstream_module.xml" id="max_fails">неудачной
57fc39924d42 Proxy/memcached/fastcgi/scgi/uwsgi: updated link in _next_upstream directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1246
diff changeset
1068 попыткой</link> работы с сервером.
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1069 Случаи <literal>error</literal>, <literal>timeout</literal> и
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1070 <literal>invalid_header</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1071 всегда считаются неудачными попытками, даже если они не указаны в директиве.
1956
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
1072 Случаи <literal>http_500</literal>, <literal>http_503</literal>
dd96a09dd4f7 Documented support for "429 Too Many Requests" response.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1923
diff changeset
1073 и <literal>http_429</literal>
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1074 считаются неудачными попытками, только если они указаны в директиве.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1075 Случаи <literal>http_403</literal> и <literal>http_404</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1076 никогда не считаются неудачными попытками.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1077 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1078
1290
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1079 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1080 Передача запроса следующему серверу может быть ограничена по
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1081 <link id="uwsgi_next_upstream_tries">количеству попыток</link>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1082 и по <link id="uwsgi_next_upstream_timeout">времени</link>.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1083 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1084
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1085 </directive>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1086
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1087
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1088 <directive name="uwsgi_next_upstream_timeout">
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1089 <syntax><value>время</value></syntax>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1090 <default>0</default>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1091 <context>http</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1092 <context>server</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1093 <context>location</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1094 <appeared-in>1.7.5</appeared-in>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1095
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1096 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1097 Ограничивает время, в течение которого возможна передача запроса
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1098 <link id="uwsgi_next_upstream">следующему серверу</link>.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1099 Значение <literal>0</literal> отключает это ограничение.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1100 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1101
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1102 </directive>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1103
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1104
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1105 <directive name="uwsgi_next_upstream_tries">
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1106 <syntax><value>число</value></syntax>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1107 <default>0</default>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1108 <context>http</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1109 <context>server</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1110 <context>location</context>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1111 <appeared-in>1.7.5</appeared-in>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1112
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1113 <para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1114 Ограничивает число допустимых попыток для передачи запроса
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1115 <link id="uwsgi_next_upstream">следующему серверу</link>.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1116 Значение <literal>0</literal> отключает это ограничение.
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1117 </para>
f5cc9f2aef9a Proxy/memcached/fastcgi/scgi/uwsgi: _next_upstream_timeout,_next_upstream_tries.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1289
diff changeset
1118
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1119 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1120
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1121
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1122 <directive name="uwsgi_no_cache">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1123 <syntax><value>строка</value> ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1124 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1125 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1126 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1127 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1128
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1129 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1130 Задаёт условия, при которых ответ не будет сохраняться в кэш.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1131 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1132 то ответ не будет сохранён:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1133 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1134 uwsgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1135 uwsgi_no_cache $http_pragma $http_authorization;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1136 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1137 Можно использовать совместно с директивой <link id="uwsgi_cache_bypass"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1138 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1139
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1140 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1141
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1142
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1143 <directive name="uwsgi_param">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1144 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1145 <value>параметр</value> <value>значение</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1146 [<literal>if_not_empty</literal>]</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1147 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1148 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1149 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1150 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1151
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1152 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1153 Задаёт <value>параметр</value>, который будет передаваться uwsgi-серверу.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1154 В качестве значения можно использовать текст, переменные и их комбинации.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1155 Директивы наследуются с предыдущего уровня при условии, что на данном
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1156 уровне не описаны свои директивы <literal>uwsgi_param</literal>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1157 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1158
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1159 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1160 Стандартные
1923
66a30a380fba Fixed links to tools.ietf.org.
Ruslan Ermilov <ru@nginx.com>
parents: 1912
diff changeset
1161 <link url="https://tools.ietf.org/html/rfc3875#section-4.1">переменные
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1162 окружения CGI</link>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1163 должны передаваться как заголовки uwsgi, см. файл <path>uwsgi_params</path>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1164 из дистрибутива:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1165 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1166 location / {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1167 include uwsgi_params;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1168 ...
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1169 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1170 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1171 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1172
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1173 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1174 Если директива указана с <literal>if_not_empty</literal> (1.1.11),
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1175 то такой параметр с пустым значением передаваться на сервер не будет:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1176 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1177 uwsgi_param HTTPS $https if_not_empty;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1178 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1179 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1180
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1181 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1182
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1183
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1184 <directive name="uwsgi_pass">
1192
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1185 <syntax>[<value>протокол</value>://]<value>адрес</value></syntax>
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1186 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1187 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1188 <context>if в location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1189
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1190 <para>
1192
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1191 Задаёт протокол и адрес uwsgi-сервера.
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1192 В качестве протокола можно указать
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1193 “<literal>uwsgi</literal>” или “<literal>suwsgi</literal>”
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1194 (secured uwsgi, uwsgi через SSL).
1622
c4c1dddfedac Unified *_pass address descriptions.
Ruslan Ermilov <ru@nginx.com>
parents: 1582
diff changeset
1195 Адрес может быть указан в виде доменного имени или IP-адреса,
c4c1dddfedac Unified *_pass address descriptions.
Ruslan Ermilov <ru@nginx.com>
parents: 1582
diff changeset
1196 и порта:
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1197 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1198 uwsgi_pass localhost:9000;
1192
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1199 uwsgi_pass uwsgi://localhost:9000;
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1200 uwsgi_pass suwsgi://[2001:db8::1]:9090;
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1201 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1202 или в виде пути UNIX-сокета:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1203 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1204 uwsgi_pass unix:/tmp/uwsgi.socket;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1205 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1206 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1207
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1208 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1209 Если доменному имени соответствует несколько адресов, то все они будут
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1210 использоваться по очереди (round-robin).
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1211 И, кроме того, адрес может быть
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1212 <link doc="ngx_http_upstream_module.xml">группой серверов</link>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1213 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1214
1192
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1215 <para>
1991
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1978
diff changeset
1216 В значении параметра можно использовать переменные.
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1978
diff changeset
1217 В этом случае, если адрес указан в виде доменного имени,
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1978
diff changeset
1218 имя ищется среди описанных
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1978
diff changeset
1219 <link doc="ngx_http_upstream_module.xml">групп серверов</link>
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1978
diff changeset
1220 и если не найдено, то определяется с помощью
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1978
diff changeset
1221 <link doc="ngx_http_core_module.xml" id="resolver"/>’а.
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1978
diff changeset
1222 </para>
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1978
diff changeset
1223
4f3dd2f548cf Documented variables in fastcgi_pass, scgi_pass, and uwsgi_pass.
Ruslan Ermilov <ru@nginx.com>
parents: 1978
diff changeset
1224 <para>
1192
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1225 <note>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1226 Протокол secured uwsgi поддерживается начиная с версии 1.5.8.
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1227 </note>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1228 </para>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1229
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1230 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1231
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1232
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1233 <directive name="uwsgi_pass_header">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1234 <syntax><value>поле</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1235 <default/>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1236 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1237 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1238 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1239
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1240 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1241 Разрешает передавать от uwsgi-сервера клиенту
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1242 <link id="uwsgi_hide_header">запрещённые для передачи</link> поля заголовка.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1243 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1244
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1245 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1246
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1247
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1248 <directive name="uwsgi_pass_request_body">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1249 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1250 <default>on</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1251 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1252 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1253 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1254
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1255 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1256 Позволяет запретить передачу исходного тела запроса
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1257 на uwsgi-сервер.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1258 См. также директиву <link id="uwsgi_pass_request_headers"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1259 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1260
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1261 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1262
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1263
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1264 <directive name="uwsgi_pass_request_headers">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1265 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1266 <default>on</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1267 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1268 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1269 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1270
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1271 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1272 Позволяет запретить передачу полей заголовка исходного запроса на
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1273 uwsgi-сервер.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1274 См. также директивы <link id="uwsgi_pass_request_body"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1275 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1276
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1277 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1278
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1279
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1280 <directive name="uwsgi_read_timeout">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1281 <syntax><value>время</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1282 <default>60s</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1283 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1284 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1285 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1286
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1287 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1288 Задаёт таймаут при чтении ответа uwsgi-сервера.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1289 Таймаут устанавливается не на всю передачу ответа,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1290 а только между двумя операциями чтения.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1291 Если по истечении этого времени uwsgi-сервер ничего не передаст,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1292 соединение закрывается.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1293 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1294
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1295 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1296
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1297
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1298 <directive name="uwsgi_request_buffering">
1659
680cbf783efe Fixed some misuses of "value".
Ruslan Ermilov <ru@nginx.com>
parents: 1622
diff changeset
1299 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1300 <default>on</default>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1301 <context>http</context>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1302 <context>server</context>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1303 <context>location</context>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1304 <appeared-in>1.7.11</appeared-in>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1305
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1306 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1307 Разрешает или запрещает использовать буферизацию тела запроса клиента.
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1308 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1309
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1310 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1311 Если буферизация включена, то тело запроса полностью
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1312 <link doc="ngx_http_core_module.xml" id="client_body_buffer_size">читается</link>
1440
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1313 от клиента перед отправкой запроса на uwsgi-сервер.
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1314 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1315
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1316 <para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1317 Если буферизация выключена, то тело запроса отправляется
1440
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1318 на uwsgi-сервер сразу же по мере его поступления.
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1319 В этом случае запрос не может быть передан
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1320 <link id="uwsgi_next_upstream">следующему серверу</link>,
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1321 если nginx уже начал отправку тела запроса.
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1322 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1323
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1324 <para>
1440
657885fd2b96 Corrected description of proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1437
diff changeset
1325 Если для отправки тела исходного запроса используется HTTP/1.1
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1326 и передача данных частями (chunked transfer encoding),
1443
a55553729d63 Unified text of scgi and uwsgi request buffering with proxy.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1440
diff changeset
1327 то тело запроса буферизуется независимо от значения директивы.
1437
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1328 </para>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1329
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1330 </directive>
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1331
8e7995bb8c6b Documented proxy_request_buffering and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1384
diff changeset
1332
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1333 <directive name="uwsgi_send_timeout">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1334 <syntax><value>время</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1335 <default>60s</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1336 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1337 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1338 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1339
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1340 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1341 Задаёт таймаут при передаче запроса uwsgi-серверу.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1342 Таймаут устанавливается не на всю передачу запроса,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1343 а только между двумя операциями записи.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1344 Если по истечении этого времени uwsgi-сервер не примет новых данных,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1345 соединение закрывается.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1346 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1347
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1348 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1349
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1350
2254
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1351 <directive name="uwsgi_socket_keepalive">
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1352 <syntax><literal>on</literal> | <literal>off</literal></syntax>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1353 <default>off</default>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1354 <context>http</context>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1355 <context>server</context>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1356 <context>location</context>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1357 <appeared-in>1.15.6</appeared-in>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1358
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1359 <para>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1360 Конфигурирует поведение “TCP keepalive”
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1361 для исходящих соединений к uwsgi-серверу.
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1362 По умолчанию для сокета действуют настройки операционной системы.
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1363 Если указано значение “<literal>on</literal>”, то
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1364 для сокета включается параметр <c-def>SO_KEEPALIVE</c-def>.
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1365 </para>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1366
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1367 </directive>
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1368
d765ffffd08c Documented proxy_socket_keepalive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2090
diff changeset
1369
1372
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1370 <directive name="uwsgi_ssl_certificate">
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1371 <syntax><value>файл</value></syntax>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1372 <default/>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1373 <context>http</context>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1374 <context>server</context>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1375 <context>location</context>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1376 <appeared-in>1.7.8</appeared-in>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1377
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1378 <para>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1379 Задаёт <value>файл</value> с сертификатом в формате PEM
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1380 для аутентификации на suwsgi-сервере.
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1381 </para>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1382
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1383 </directive>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1384
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1385
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1386 <directive name="uwsgi_ssl_certificate_key">
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1387 <syntax><value>файл</value></syntax>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1388 <default/>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1389 <context>http</context>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1390 <context>server</context>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1391 <context>location</context>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1392 <appeared-in>1.7.8</appeared-in>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1393
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1394 <para>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1395 Задаёт <value>файл</value> с секретным ключом в формате PEM
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1396 для аутентификации на suwsgi-сервере.
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1397 </para>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1398
1456
acba294382d6 Documented engine support in ssl_certificate_key and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1399 <para>
acba294382d6 Documented engine support in ssl_certificate_key and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1400 Вместо <value>файла</value> можно указать значение
acba294382d6 Documented engine support in ssl_certificate_key and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1401 <literal>engine</literal>:<value>имя</value>:<value>id</value> (1.7.9),
acba294382d6 Documented engine support in ssl_certificate_key and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1402 которое загружает ключ с указанным <value>id</value>
acba294382d6 Documented engine support in ssl_certificate_key and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1403 из OpenSSL engine с заданным <value>именем</value>.
acba294382d6 Documented engine support in ssl_certificate_key and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1404 </para>
acba294382d6 Documented engine support in ssl_certificate_key and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1443
diff changeset
1405
1372
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1406 </directive>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1407
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1408
1192
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1409 <directive name="uwsgi_ssl_ciphers">
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1410 <syntax><value>ciphers</value></syntax>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1411 <default>DEFAULT</default>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1412 <context>http</context>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1413 <context>server</context>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1414 <context>location</context>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1415 <appeared-in>1.5.8</appeared-in>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1416
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1417 <para>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1418 Описывает разрешённые шифры для запросов к suwsgi-серверу.
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1419 Шифры задаются в формате, поддерживаемом библиотекой OpenSSL.
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1420 </para>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1421
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1422 <para>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1423 Полный список можно посмотреть с помощью команды
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1424 “<command>openssl ciphers</command>”.
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1425 </para>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1426
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1427 </directive>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1428
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1429
1193
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1430 <directive name="uwsgi_ssl_crl">
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1431 <syntax><value>файл</value></syntax>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1432 <default/>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1433 <context>http</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1434 <context>server</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1435 <context>location</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1436 <appeared-in>1.7.0</appeared-in>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1437
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1438 <para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1439 Указывает <value>файл</value> с отозванными сертификатами (CRL)
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1440 в формате PEM, используемыми при <link id="uwsgi_ssl_verify">проверке</link>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1441 сертификата suwsgi-сервера.
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1442 </para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1443
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1444 </directive>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1445
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1446
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1447 <directive name="uwsgi_ssl_name">
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1448 <syntax><value>имя</value></syntax>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1449 <default>имя хоста из uwsgi_pass</default>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1450 <context>http</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1451 <context>server</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1452 <context>location</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1453 <appeared-in>1.7.0</appeared-in>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1454
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1455 <para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1456 Позволяет переопределить имя сервера, используемое при
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1457 <link id="uwsgi_ssl_verify">проверке</link>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1458 сертификата suwsgi-сервера, а также для
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1459 <link id="uwsgi_ssl_server_name">передачи его через SNI</link>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1460 при установлении соединения с suwsgi-сервером.
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1461 </para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1462
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1463 <para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1464 По умолчанию используется имя хоста из <link id="uwsgi_pass"/>.
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1465 </para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1466
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1467 </directive>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1468
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1469
1372
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1470 <directive name="uwsgi_ssl_password_file">
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1471 <syntax><value>файл</value></syntax>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1472 <default/>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1473 <context>http</context>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1474 <context>server</context>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1475 <context>location</context>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1476 <appeared-in>1.7.8</appeared-in>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1477
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1478 <para>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1479 Задаёт <value>файл</value> с паролями от
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1480 <link id="uwsgi_ssl_certificate_key">секретных ключей</link>,
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1481 где каждый пароль указан на отдельной строке.
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1482 Пароли применяются по очереди в момент загрузки ключа.
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1483 </para>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1484
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1485 </directive>
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1486
e0e1e5db06bb Documented the proxy_ssl_certificate directive and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1353
diff changeset
1487
1192
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1488 <directive name="uwsgi_ssl_protocols">
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1489 <syntax>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1490 [<literal>SSLv2</literal>]
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1491 [<literal>SSLv3</literal>]
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1492 [<literal>TLSv1</literal>]
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1493 [<literal>TLSv1.1</literal>]
1978
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1973
diff changeset
1494 [<literal>TLSv1.2</literal>]
8f1a568a8bbf Documented "TLSv1.3" parameter of the "ssl_protocols" directive.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1973
diff changeset
1495 [<literal>TLSv1.3</literal>]</syntax>
1499
3687cc9a3592 Removed SSLv3 from the default value of ssl_protocols and friends.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1456
diff changeset
1496 <default>TLSv1 TLSv1.1 TLSv1.2</default>
1192
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1497 <context>http</context>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1498 <context>server</context>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1499 <context>location</context>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1500 <appeared-in>1.5.8</appeared-in>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1501
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1502 <para>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1503 Разрешает указанные протоколы для запросов к suwsgi-серверу.
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1504 </para>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1505
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1506 </directive>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1507
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1508
1193
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1509 <directive name="uwsgi_ssl_server_name">
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1510 <syntax><literal>on</literal> | <literal>off</literal></syntax>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1511 <default>off</default>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1512 <context>http</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1513 <context>server</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1514 <context>location</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1515 <appeared-in>1.7.0</appeared-in>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1516
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1517 <para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1518 Разрешает или запрещает передачу имени сервера через
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1519 <link url="http://en.wikipedia.org/wiki/Server_Name_Indication">расширение
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1520 Server Name Indication протокола TLS</link> (SNI, RFC 6066)
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1521 при установлении соединения с suwsgi-сервером.
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1522 </para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1523
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1524 </directive>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1525
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1526
1192
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1527 <directive name="uwsgi_ssl_session_reuse">
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1528 <syntax><literal>on</literal> | <literal>off</literal></syntax>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1529 <default>on</default>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1530 <context>http</context>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1531 <context>server</context>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1532 <context>location</context>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1533 <appeared-in>1.5.8</appeared-in>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1534
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1535 <para>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1536 Определяет, использовать ли повторно SSL-сессии при
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1537 работе с suwsgi-сервером.
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1538 Если в логах появляются ошибки
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1539 “<literal>SSL3_GET_FINISHED:digest check failed</literal>”,
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1540 то можно попробовать выключить
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1541 повторное использование сессий.
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1542 </para>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1543
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1544 </directive>
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1545
b5268820c3f3 Documented "suwsgi" protocol support.
Ruslan Ermilov <ru@nginx.com>
parents: 1191
diff changeset
1546
1193
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1547 <directive name="uwsgi_ssl_trusted_certificate">
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1548 <syntax><value>файл</value></syntax>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1549 <default/>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1550 <context>http</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1551 <context>server</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1552 <context>location</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1553 <appeared-in>1.7.0</appeared-in>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1554
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1555 <para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1556 Задаёт <value>файл</value> с доверенными сертификатами CA в формате PEM,
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1557 используемыми при <link id="uwsgi_ssl_verify">проверке</link>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1558 сертификата suwsgi-сервера.
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1559 </para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1560
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1561 </directive>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1562
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1563
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1564 <directive name="uwsgi_ssl_verify">
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1565 <syntax><literal>on</literal> | <literal>off</literal></syntax>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1566 <default>off</default>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1567 <context>http</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1568 <context>server</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1569 <context>location</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1570 <appeared-in>1.7.0</appeared-in>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1571
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1572 <para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1573 Разрешает или запрещает проверку сертификата suwsgi-сервера.
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1574 </para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1575
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1576 </directive>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1577
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1578
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1579 <directive name="uwsgi_ssl_verify_depth">
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1580 <syntax><value>число</value></syntax>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1581 <default>1</default>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1582 <context>http</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1583 <context>server</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1584 <context>location</context>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1585 <appeared-in>1.7.0</appeared-in>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1586
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1587 <para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1588 Устанавливает глубину проверки в цепочке сертификатов suwsgi-сервера.
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1589 </para>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1590
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1591 </directive>
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1592
0320929f8544 Documented uwsgi_ssl_verify, uwsgi_ssl_server_name, and friends.
Ruslan Ermilov <ru@nginx.com>
parents: 1192
diff changeset
1593
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1594 <directive name="uwsgi_store">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1595 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1596 <literal>on</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1597 <literal>off</literal> |
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1598 <value>строка</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1599 <default>off</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1600 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1601 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1602 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1603
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1604 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1605 Разрешает сохранение на диск файлов.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1606 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1607 указанными в директивах
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1608 <link doc="ngx_http_core_module.xml" id="alias"/> или
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1609 <link doc="ngx_http_core_module.xml" id="root"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1610 Параметр <literal>off</literal> запрещает сохранение файлов.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1611 Кроме того, имя файла можно задать явно с помощью строки с переменными:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1612 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1613 uwsgi_store /data/www$original_uri;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1614 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1615 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1616
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1617 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1618 Время изменения файлов выставляется согласно полученному полю
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1619 <header>Last-Modified</header> в заголовке ответа.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1620 Ответ сначала записывается во временный файл, а потом этот файл
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1621 переименовывается.
1724
ce3e89d13fa0 Removed unneeded comma in "Since ..." Russian constructs.
Maxim Dounin <mdounin@mdounin.ru>
parents: 1696
diff changeset
1622 Начиная с версии 0.8.9 временный файл и постоянное место хранения ответа
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1623 могут располагаться на разных файловых системах.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1624 Однако нужно учитывать,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1625 что в этом случае вместо дешёвой операции переименовывания в пределах
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1626 одной файловой системы файл копируется с одной файловой системы на другую.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1627 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1628 системе, что и каталог с временными файлами, задаваемый директивой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1629 <link id="uwsgi_temp_path"/> для данного location.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1630 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1631
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1632 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1633 Директиву можно использовать для создания локальных копий статических
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1634 неизменяемых файлов, например, так:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1635 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1636 location /images/ {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1637 root /data/www;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1638 error_page 404 = /fetch$uri;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1639 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1640
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1641 location /fetch/ {
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1642 internal;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1643
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1644 uwsgi_pass backend:9000;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1645 ...
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1646
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1647 uwsgi_store on;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1648 uwsgi_store_access user:rw group:rw all:r;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1649 uwsgi_temp_path /data/temp;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1650
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1651 alias /data/www/;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1652 }
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1653 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1654 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1655
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1656 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1657
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1658
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1659 <directive name="uwsgi_store_access">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1660 <syntax><value>пользователи</value>:<value>права</value> ...</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1661 <default>user:rw</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1662 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1663 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1664 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1665
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1666 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1667 Задаёт права доступа для создаваемых файлов и каталогов, например,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1668 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1669 uwsgi_store_access user:rw group:rw all:r;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1670 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1671 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1672
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1673 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1674 Если заданы какие-либо права для <literal>group</literal> или
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1675 <literal>all</literal>, то права для <literal>user</literal>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1676 указывать необязательно:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1677 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1678 uwsgi_store_access group:rw all:r;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1679 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1680 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1681
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1682 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1683
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1684
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1685 <directive name="uwsgi_temp_file_write_size">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1686 <syntax><value>размер</value></syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1687 <default>8k|16k</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1688 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1689 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1690 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1691
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1692 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1693 Ограничивает <value>размер</value> данных, сбрасываемых во временный файл
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1694 за один раз, при включённой буферизации ответов uwsgi-сервера
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1695 во временные файлы.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1696 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1697 директивами <link id="uwsgi_buffer_size"/> и <link id="uwsgi_buffers"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1698 Максимальный размер временного файла задаётся директивой
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1699 <link id="uwsgi_max_temp_file_size"/>.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1700 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1701
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1702 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1703
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1704
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1705 <directive name="uwsgi_temp_path">
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1706 <syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1707 <value>путь</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1708 [<value>уровень1</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1709 [<value>уровень2</value>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1710 [<value>уровень3</value>]]]</syntax>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1711 <default>uwsgi_temp</default>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1712 <context>http</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1713 <context>server</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1714 <context>location</context>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1715
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1716 <para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1717 Задаёт имя каталога для хранения временных файлов с данными,
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1718 полученными от uwsgi-серверов.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1719 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1720 Например, при такой конфигурации
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1721 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1722 uwsgi_temp_path /spool/nginx/uwsgi_temp 1 2;
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1723 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1724 временный файл будет следующего вида:
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1725 <example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1726 /spool/nginx/uwsgi_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1727 </example>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1728 </para>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1729
1384
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1730 <para>
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1731 См. также параметр <literal>use_temp_path</literal> директивы
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1732 <link id="uwsgi_cache_path"/>.
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1733 </para>
66ee77849563 Documented the use_temp_path parameter of the proxy_cache_path directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1382
diff changeset
1734
1191
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1735 </directive>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1736
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1737 </section>
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1738
ea85ba147fe9 Mechanically converted SCGI module docs to uwsgi.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1739 </module>