Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 506:657848837328
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 |