Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_core_module.xml @ 3043:9eadb98ec770

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Free nginx: removed commercial version documentation.
author Maxim Dounin <mdounin@mdounin.ru>
date Wed, 14 Feb 2024 20:05:49 +0300
parents cbd963190c15
children 3b5594157fab
comparison
equal deleted inserted replaced
3042:19e4897acb84 3043:9eadb98ec770
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_core_module" 10 <module name="Модуль ngx_http_core_module"
11 link="/ru/docs/http/ngx_http_core_module.html" 11 link="/ru/docs/http/ngx_http_core_module.html"
12 lang="ru" 12 lang="ru"
13 rev="106"> 13 rev="107">
14 14
15 <section id="directives" name="Директивы"> 15 <section id="directives" name="Директивы">
16 16
17 <directive name="absolute_redirect"> 17 <directive name="absolute_redirect">
18 <syntax><literal>on</literal> | <literal>off</literal></syntax> 18 <syntax><literal>on</literal> | <literal>off</literal></syntax>
257 <appeared-in>1.17.10</appeared-in> 257 <appeared-in>1.17.10</appeared-in>
258 258
259 <para> 259 <para>
260 Задерживает обработку неавторизованных запросов с кодом ответа 401 260 Задерживает обработку неавторизованных запросов с кодом ответа 401
261 для предотвращения атак по времени в случае ограничения доступа по 261 для предотвращения атак по времени в случае ограничения доступа по
262 <link doc="ngx_http_auth_basic_module.xml">паролю</link>, по 262 <link doc="ngx_http_auth_basic_module.xml">паролю</link> или по
263 <link doc="ngx_http_auth_request_module.xml">результату подзапроса</link> 263 <link doc="ngx_http_auth_request_module.xml">результату подзапроса</link>.
264 или по <link doc="ngx_http_auth_jwt_module.xml">JWT</link>.
265 </para> 264 </para>
266 265
267 </directive> 266 </directive>
268 267
269 268
846 845
847 <listitem> 846 <listitem>
848 запросы, перенаправленные директивами 847 запросы, перенаправленные директивами
849 <link id="error_page"/>, 848 <link id="error_page"/>,
850 <link doc="ngx_http_index_module.xml" id="index"/>, 849 <link doc="ngx_http_index_module.xml" id="index"/>,
851 <link doc="ngx_http_internal_redirect_module.xml" id="internal_redirect"/>,
852 <link doc="ngx_http_random_index_module.xml" id="random_index"/> и 850 <link doc="ngx_http_random_index_module.xml" id="random_index"/> и
853 <link id="try_files"/>; 851 <link id="try_files"/>;
854 </listitem> 852 </listitem>
855 853
856 <listitem> 854 <listitem>
1063 или 1061 или
1064 <literal>PATCH</literal>. 1062 <literal>PATCH</literal>.
1065 Если разрешён метод <literal>GET</literal>, то метод 1063 Если разрешён метод <literal>GET</literal>, то метод
1066 <literal>HEAD</literal> также будет разрешён. 1064 <literal>HEAD</literal> также будет разрешён.
1067 Доступ к остальным методам может быть ограничен при помощи директив модулей 1065 Доступ к остальным методам может быть ограничен при помощи директив модулей
1068 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>, 1066 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link> и
1069 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link> 1067 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>:
1070 и
1071 <link doc="ngx_http_auth_jwt_module.xml">ngx_http_auth_jwt_module</link>
1072 (1.13.10):
1073 <example> 1068 <example>
1074 limit_except GET { 1069 limit_except GET {
1075 allow 192.168.1.0/32; 1070 allow 192.168.1.0/32;
1076 deny all; 1071 deny all;
1077 } 1072 }
2180 <directive name="resolver"> 2175 <directive name="resolver">
2181 <syntax> 2176 <syntax>
2182 <value>адрес</value> ... 2177 <value>адрес</value> ...
2183 [<literal>valid</literal>=<value>время</value>] 2178 [<literal>valid</literal>=<value>время</value>]
2184 [<literal>ipv4</literal>=<literal>on</literal>|<literal>off</literal>] 2179 [<literal>ipv4</literal>=<literal>on</literal>|<literal>off</literal>]
2185 [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>] 2180 [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]</syntax>
2186 [<literal>status_zone</literal>=<value>зона</value>]</syntax>
2187 <default/> 2181 <default/>
2188 <context>http</context> 2182 <context>http</context>
2189 <context>server</context> 2183 <context>server</context>
2190 <context>location</context> 2184 <context>location</context>
2191 2185
2233 Для предотвращения DNS-спуфинга рекомендуется 2227 Для предотвращения DNS-спуфинга рекомендуется
2234 использовать DNS-серверы в защищённой доверенной локальной сети. 2228 использовать DNS-серверы в защищённой доверенной локальной сети.
2235 </note> 2229 </note>
2236 </para> 2230 </para>
2237 2231
2238 <para id="resolver_status_zone">
2239 Необязательный параметр <literal>status_zone</literal> (1.17.1)
2240 включает
2241 <link doc="ngx_http_api_module.xml" id="resolvers_">сбор информации</link>
2242 о запросах и ответах сервера DNS
2243 в указанной <value>зоне</value>.
2244 Параметр доступен как часть
2245 <commercial_version>коммерческой подписки</commercial_version>.
2246 </para>
2247
2248 </directive> 2232 </directive>
2249 2233
2250 2234
2251 <directive name="resolver_timeout"> 2235 <directive name="resolver_timeout">
2252 <syntax><value>время</value></syntax> 2236 <syntax><value>время</value></syntax>
2309 2293
2310 <para> 2294 <para>
2311 Разрешает доступ, если все (<literal>all</literal>) 2295 Разрешает доступ, если все (<literal>all</literal>)
2312 или хотя бы один (<literal>any</literal>) из модулей 2296 или хотя бы один (<literal>any</literal>) из модулей
2313 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>, 2297 <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>,
2314 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>, 2298 <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>
2299 или
2315 <link doc="ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link> 2300 <link doc="ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link>
2316 или
2317 <link doc="ngx_http_auth_jwt_module.xml">ngx_http_auth_jwt_module</link>
2318 разрешают доступ. 2301 разрешают доступ.
2319 </para> 2302 </para>
2320 2303
2321 <para> 2304 <para>
2322 Пример: 2305 Пример:
2664 2647
2665 <directive name="server_tokens"> 2648 <directive name="server_tokens">
2666 <syntax> 2649 <syntax>
2667 <literal>on</literal> | 2650 <literal>on</literal> |
2668 <literal>off</literal> | 2651 <literal>off</literal> |
2669 <literal>build</literal> | 2652 <literal>build</literal></syntax>
2670 <value>строка</value></syntax>
2671 <default>on</default> 2653 <default>on</default>
2672 <context>http</context> 2654 <context>http</context>
2673 <context>server</context> 2655 <context>server</context>
2674 <context>location</context> 2656 <context>location</context>
2675 2657
2680 2662
2681 <para id="server_tokens_build"> 2663 <para id="server_tokens_build">
2682 Если указан параметр <literal>build</literal> (1.11.10), 2664 Если указан параметр <literal>build</literal> (1.11.10),
2683 то наряду с версией nginx’а будет также выдаваться 2665 то наряду с версией nginx’а будет также выдаваться
2684 <link doc="../configure.xml" id="build">имя сборки</link>. 2666 <link doc="../configure.xml" id="build">имя сборки</link>.
2685 </para>
2686
2687 <para>
2688 Дополнительно, как часть
2689 <commercial_version>коммерческой подписки</commercial_version>,
2690 начиная с версии 1.9.13
2691 подписи на страницах ошибок и
2692 значение поля <header>Server</header> заголовка ответа
2693 можно задать явно с помощью строки с переменными.
2694 Пустая строка запрещает выдачу поля <header>Server</header>.
2695 </para> 2667 </para>
2696 2668
2697 </directive> 2669 </directive>
2698 2670
2699 2671