Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_proxy_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 37e082fd009c
children
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_proxy_module" 10 <module name="Модуль ngx_http_proxy_module"
11 link="/ru/docs/http/ngx_http_proxy_module.html" 11 link="/ru/docs/http/ngx_http_proxy_module.html"
12 lang="ru" 12 lang="ru"
13 rev="76"> 13 rev="77">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 Модуль <literal>ngx_http_proxy_module</literal> позволяет передавать 18 Модуль <literal>ngx_http_proxy_module</literal> позволяет передавать
408 [<literal>manager_files</literal>=<value>число</value>] 408 [<literal>manager_files</literal>=<value>число</value>]
409 [<literal>manager_sleep</literal>=<value>время</value>] 409 [<literal>manager_sleep</literal>=<value>время</value>]
410 [<literal>manager_threshold</literal>=<value>время</value>] 410 [<literal>manager_threshold</literal>=<value>время</value>]
411 [<literal>loader_files</literal>=<value>число</value>] 411 [<literal>loader_files</literal>=<value>число</value>]
412 [<literal>loader_sleep</literal>=<value>время</value>] 412 [<literal>loader_sleep</literal>=<value>время</value>]
413 [<literal>loader_threshold</literal>=<value>время</value>] 413 [<literal>loader_threshold</literal>=<value>время</value>]</syntax>
414 [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
415 [<literal>purger_files</literal>=<value>число</value>]
416 [<literal>purger_sleep</literal>=<value>время</value>]
417 [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
418 <default/> 414 <default/>
419 <context>http</context> 415 <context>http</context>
420 416
421 <para> 417 <para>
422 Задаёт путь и другие параметры кэша. 418 Задаёт путь и другие параметры кэша.
457 <para> 453 <para>
458 Кроме того, все активные ключи и информация о данных хранятся в зоне 454 Кроме того, все активные ключи и информация о данных хранятся в зоне
459 разделяемой памяти, <value>имя</value> и <value>размер</value> которой 455 разделяемой памяти, <value>имя</value> и <value>размер</value> которой
460 задаются параметром <literal>keys_zone</literal>. 456 задаются параметром <literal>keys_zone</literal>.
461 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей. 457 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей.
462 <note>
463 Как часть
464 <commercial_version>коммерческой подписки</commercial_version>
465 в зоне разделяемой памяти также хранится расширенная
466 <link doc="ngx_http_api_module.xml" id="http_caches_">информация</link> о кэше,
467 поэтому для хранения аналогичного количества ключей необходимо указывать
468 больший размер зоны.
469 Например
470 зоны размером в 1 мегабайт достаточно для хранения около 4 тысяч ключей.
471 </note>
472 </para> 458 </para>
473 459
474 <para> 460 <para>
475 Если к данным кэша не обращаются в течение времени, заданного параметром 461 Если к данным кэша не обращаются в течение времени, заданного параметром
476 <literal>inactive</literal>, то данные удаляются, независимо от их свежести. 462 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
509 Между итерациями делается пауза на время, заданное параметром 495 Между итерациями делается пауза на время, заданное параметром
510 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд). 496 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
511 </para> 497 </para>
512 498
513 <para> 499 <para>
514 Кроме того,
515 следующие параметры доступны как часть
516 <commercial_version>коммерческой подписки</commercial_version>:
517 </para>
518
519 <para>
520 <list type="tag">
521
522 <tag-name id="purger">
523 <literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
524 </tag-name>
525 <tag-desc>
526 Указывает, будут ли записи в кэше, соответствующие
527 <link id="proxy_cache_purge">маске</link>,
528 удалены с диска при помощи процесса “cache purger” (1.7.12).
529 Установка параметра в значение <literal>on</literal>
530 (по умолчанию <literal>off</literal>)
531 активирует процесс “cache purger”, который
532 проходит по всем записям в кэше
533 и удаляет записи, соответствующие этой маске.
534 </tag-desc>
535
536 <tag-name id="purger_files">
537 <literal>purger_files</literal>=<value>число</value>
538 </tag-name>
539 <tag-desc>
540 Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
541 По умолчанию <literal>purger_files</literal> равен 10.
542 </tag-desc>
543
544 <tag-name id="purger_threshold">
545 <literal>purger_threshold</literal>=<value>время</value>
546 </tag-name>
547 <tag-desc>
548 Задаёт продолжительность одной итерации (1.7.12).
549 По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
550 </tag-desc>
551
552 <tag-name id="purger_sleep">
553 <literal>purger_sleep</literal>=<value>время</value>
554 </tag-name>
555 <tag-desc>
556 Задаёт паузу между итерациями (1.7.12).
557 По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
558 </tag-desc>
559
560 </list>
561 </para>
562
563 <para>
564 <note> 500 <note>
565 В версиях 1.7.3, 1.7.7 и 1.11.10 формат заголовка кэша был изменён. 501 В версиях 1.7.3, 1.7.7 и 1.11.10 формат заголовка кэша был изменён.
566 При обновлении на более новую версию nginx 502 При обновлении на более новую версию nginx
567 ранее закэшированные ответы будут считаться недействительными. 503 ранее закэшированные ответы будут считаться недействительными.
568 </note>
569 </para>
570
571 </directive>
572
573
574 <directive name="proxy_cache_purge">
575 <syntax>строка ...</syntax>
576 <default/>
577 <context>http</context>
578 <context>server</context>
579 <context>location</context>
580 <appeared-in>1.5.7</appeared-in>
581
582 <para>
583 Задаёт условия, при которых запрос будет считаться запросом
584 на очистку кэша.
585 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
586 то запись в кэше с соответствующим
587 <link id="proxy_cache_key">ключом кэширования</link> удаляется.
588 В результате успешной операции возвращается ответ с кодом
589 <http-status code="204" text="No Content"/>.
590 </para>
591
592 <para>
593 Если <link id="proxy_cache_key">ключ кэширования</link>
594 запроса на очистку заканчивается
595 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
596 этой маске, будут удалены из кэша.
597 Тем не менее, эти записи будут оставаться на диске или до момента удаления
598 из-за <link id="proxy_cache_path">отсутствия обращения к данным</link>,
599 или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
600 или до попытки клиента получить к ним доступ.
601 </para>
602
603 <para>
604 Пример конфигурации:
605 <example>
606 proxy_cache_path /data/nginx/cache keys_zone=cache_zone:10m;
607
608 map $request_method $purge_method {
609 PURGE 1;
610 default 0;
611 }
612
613 server {
614 ...
615 location / {
616 proxy_pass http://backend;
617 proxy_cache cache_zone;
618 proxy_cache_key $uri;
619 proxy_cache_purge $purge_method;
620 }
621 }
622 </example>
623 <note>
624 Функциональность доступна как часть
625 <commercial_version>коммерческой подписки</commercial_version>.
626 </note> 504 </note>
627 </para> 505 </para>
628 506
629 </directive> 507 </directive>
630 508