Mercurial > hg > nginx-site
view xml/ru/docs/http/ngx_http_spdy_module.xml @ 2182:7865ca0da0ab
Merged HTTP request,response, and reply in njs.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 19 Jun 2018 15:43:42 +0300 |
parents | 5ea0a0ff7271 |
children | 9a8d15333a58 |
line wrap: on
line source
<?xml version="1.0"?> <!-- Copyright (C) Nginx, Inc. --> <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> <module name="Модуль ngx_http_spdy_module" link="/ru/docs/http/ngx_http_spdy_module.html" lang="ru" rev="10"> <section id="summary"> <para> Модуль <literal>ngx_http_spdy_module</literal> обеспечивает экспериментальную поддержку <link url="http://www.chromium.org/spdy/spdy-protocol">SPDY</link>. В настоящий момент реализован <link url="http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft3-1">draft 3.1</link> протокола SPDY. <note> До версии 1.5.10 был реализован <link url="http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft2">draft 2</link> протокола SPDY. </note> </para> <para> По умолчанию этот модуль не собирается, его сборку необходимо разрешить с помощью конфигурационного параметра <literal>--with-http_spdy_module</literal>. </para> <para> <note> Этот модуль был заменён модулем <link doc="ngx_http_v2_module.xml">ngx_http_v2_module</link> в версии 1.9.5. </note> </para> </section> <section id="issues" name="Известные проблемы"> <para> Модуль экспериментальный, поэтому возможно всё. </para> <para> Текущая реализация протокола SPDY не поддерживает server push. </para> <para> До версии 1.5.9 скорость передачи ответа клиенту в SPDY-соединении не могла быть <link doc="ngx_http_core_module.xml" id="limit_rate">ограничена</link>. </para> <para> Буферизация тела запроса клиента не может быть выключена независимо от значения директив <link doc="ngx_http_proxy_module.xml" id="proxy_request_buffering"/>, <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_request_buffering"/>, <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_request_buffering"/> и <link doc="ngx_http_scgi_module.xml" id="scgi_request_buffering"/>. </para> </section> <section id="example" name="Пример конфигурации"> <para> <example> server { listen 443 ssl spdy; ssl_certificate server.crt; ssl_certificate_key server.key; ... } </example> <note> Для того чтобы одновременно принимать <link doc="ngx_http_ssl_module.xml">HTTPS</link> и SPDY соединения на том же порту, используемая библиотека <link url="http://www.openssl.org">OpenSSL</link> должна поддерживать расширение Next Protocol Negotiation протокола TLS, доступное с версии OpenSSL 1.0.1. </note> </para> </section> <section id="directives" name="Директивы"> <directive name="spdy_chunk_size"> <syntax><value>размер</value></syntax> <default>8k</default> <context>http</context> <context>server</context> <context>location</context> <appeared-in>1.5.9</appeared-in> <para> Задаёт максимальный размер частей, на которые будет <link url="http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft2#TOC-Data-frames"> разделяться</link> тело ответа. Слишком маленькое значение может привести к росту накладных расходов. Слишком большое значение может негативно сказаться на приоритизации из-за <link url="http://en.wikipedia.org/wiki/Head-of-line_blocking"> блокировки очереди</link>. </para> </directive> <directive name="spdy_headers_comp"> <syntax><value>степень</value></syntax> <default>0</default> <context>http</context> <context>server</context> <para> Устанавливает <value>степень</value> сжатия заголовков ответа в диапазоне от 1 (быстрее, но хуже сжатие) до 9 (медленнее, лучшее сжатие). Специальное значение 0 отключает сжатие заголовков. </para> </directive> </section> <section id="variables" name="Встроенные переменные"> <para> Модуль <literal>ngx_http_spdy_module</literal> поддерживает следующие встроенные переменные: <list type="tag" compact="no"> <tag-name id="var_spdy"><var>$spdy</var></tag-name> <tag-desc> версия протокола SPDY для SPDY-соединений, либо пустая строка; </tag-desc> <tag-name id="var_spdy_request_priority"><var>$spdy_request_priority</var> </tag-name> <tag-desc> приоритет запроса для SPDY-соединений, либо пустая строка. </tag-desc> </list> </para> </section> </module>