Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 506:657848837328

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented how nginx processes proxied server's response header fields (X-Accel-*, Expires, Cache-Control, Set-Cookie) that can be ignored.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 24 Apr 2012 07:32:41 +0000
parents 695f83494c19
children d00a4f9b1c5d
comparison
equal deleted inserted replaced
505:837bcf62b628 506:657848837328
77 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же 77 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
78 по мере его поступления. 78 по мере его поступления.
79 nginx не пытается считать весь ответ проксируемого сервера. 79 nginx не пытается считать весь ответ проксируемого сервера.
80 Максимальный размер данных, который nginx может принять от сервера 80 Максимальный размер данных, который nginx может принять от сервера
81 за один раз, задаётся директивой <link id="proxy_buffer_size"/>. 81 за один раз, задаётся директивой <link id="proxy_buffer_size"/>.
82 </para>
83
84 <para>
85 Буферизация может быть также включена или выключена путём передачи
86 значения “<literal>yes</literal>” или “<literal>no</literal>” в поле
87 <header>X-Accel-Buffering</header> заголовка ответа.
88 Эту возможность можно запретить с помощью директивы
89 <link doc="ngx_http_proxy_module.xml" id="proxy_ignore_headers"/>.
82 </para> 90 </para>
83 91
84 </directive> 92 </directive>
85 93
86 94
365 proxy_cache_valid 301 1h; 373 proxy_cache_valid 301 1h;
366 proxy_cache_valid any 1m; 374 proxy_cache_valid any 1m;
367 </example> 375 </example>
368 </para> 376 </para>
369 377
378 <para>
379 Параметры кэширования могут также быть заданы непосредственно
380 в заголовке ответа.
381 Такой способ приоритетнее, чем задание времени кэширования с помощью директивы.
382 Поле заголовка <header>X-Accel-Expires</header> задаёт время кэширования
383 ответа в секундах.
384 Значение 0 запрещает кэшировать ответ.
385 Если значение начинается с префикса <literal>@</literal>, оно задаёт абсолютное
386 время в секундах с начала эпохи, до которого ответ может быть закэширован.
387 Если в заголовке нет поля <header>X-Accel-Expires</header>,
388 параметры кэширования определяются по полям заголовка
389 <header>Expires</header> или <header>Cache-Control</header>.
390 Ответ, в заголовке которого есть поле <header>Set-Cookie</header>,
391 не будет кэшироваться.
392 Обработка одного или более из этих полей заголовка может быть отключена
393 при помощи директивы <link id="proxy_ignore_headers"/>.
394 </para>
395
370 </directive> 396 </directive>
371 397
372 398
373 <directive name="proxy_connect_timeout"> 399 <directive name="proxy_connect_timeout">
374 <syntax><value>время</value></syntax> 400 <syntax><value>время</value></syntax>
588 В директиве можно указать поля <header>X-Accel-Redirect</header>, 614 В директиве можно указать поля <header>X-Accel-Redirect</header>,
589 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6), 615 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6),
590 <header>X-Accel-Buffering</header> (1.1.6), 616 <header>X-Accel-Buffering</header> (1.1.6),
591 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, 617 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
592 <header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44). 618 <header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44).
619 </para>
620
621 <para>
622 Если не запрещено, обработка этих полей заголовка заключается в следующем:
623 <list type="bullet" compact="no">
624
625 <listitem>
626 <header>X-Accel-Expires</header>, <header>Expires</header>,
627 <header>Cache-Control</header> и <header>Set-Cookie</header>
628 задают параметры <link id="proxy_cache_valid">кэширования</link> ответа;
629 </listitem>
630
631 <listitem>
632 <header>X-Accel-Redirect</header> производит
633 <link doc="ngx_http_core_module.xml" id="internal">внутреннее
634 перенаправление</link> на указанный URI;
635 </listitem>
636
637 <listitem>
638 <header>X-Accel-Limit-Rate</header> задаёт
639 <link doc="ngx_http_core_module.xml" id="limit_rate">ограничение
640 скорости</link> передачи ответа клиенту;
641 </listitem>
642
643 <listitem>
644 <header>X-Accel-Buffering</header> включает или выключает
645 <link id="proxy_buffering">буферизацию</link> ответа;
646 </listitem>
647
648 <listitem>
649 <header>X-Accel-Charset</header> задаёт желаемую
650 <link doc="ngx_http_charset_module.xml" id="charset">кодировку</link>
651 ответа.
652 </listitem>
653
654 </list>
593 </para> 655 </para>
594 656
595 </directive> 657 </directive>
596 658
597 659