comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 351:a4fa80755eab

Consistently strip initial offset in examples.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 24 Jan 2012 11:01:22 +0000
parents 1fb1c077658b
children bb51d3e17dd0
comparison
equal deleted inserted replaced
350:55c1c4a1748f 351:a4fa80755eab
531 <para> 531 <para>
532 Задаёт адрес проксируемоего сервера и URI, на который 532 Задаёт адрес проксируемоего сервера и URI, на который
533 будет отображаться location. 533 будет отображаться location.
534 Адрес может быть указан в виде доменного имени или адреса, и порта, например, 534 Адрес может быть указан в виде доменного имени или адреса, и порта, например,
535 <example> 535 <example>
536 proxy_pass http://localhost:8000/uri/; 536 proxy_pass http://localhost:8000/uri/;
537 </example> 537 </example>
538 или в виде пути UNIX-сокета: 538 или в виде пути UNIX-сокета:
539 <example> 539 <example>
540 proxy_pass http://unix:/tmp/backend.socket:/uri/; 540 proxy_pass http://unix:/tmp/backend.socket:/uri/;
541 </example> 541 </example>
542 путь указан после слова “<literal>unix</literal>” 542 путь указан после слова “<literal>unix</literal>”
543 и заключён между двумя двоеточиями. 543 и заключён между двумя двоеточиями.
544 </para> 544 </para>
545 545
611 611
612 <para> 612 <para>
613 Имя сервера, его порт и передаваемый URI можно также полностью задать 613 Имя сервера, его порт и передаваемый URI можно также полностью задать
614 с помощью переменных: 614 с помощью переменных:
615 <example> 615 <example>
616 proxy_pass http://$host$uri; 616 proxy_pass http://$host$uri;
617 </example> 617 </example>
618 или так: 618 или так:
619 <example> 619 <example>
620 proxy_pass $request; 620 proxy_pass $request;
621 </example> 621 </example>
622 </para> 622 </para>
623 623
624 <para> 624 <para>
625 В этом случае имя сервера ищется среди описанных 625 В этом случае имя сервера ищется среди описанных
679 проксируемого сервера. 679 проксируемого сервера.
680 Предположим, проксируемый сервер вернул поле заголовка 680 Предположим, проксируемый сервер вернул поле заголовка
681 “<literal>Location: http://localhost:8000/two/some/uri/</literal>”. 681 “<literal>Location: http://localhost:8000/two/some/uri/</literal>”.
682 Директива 682 Директива
683 <example> 683 <example>
684 proxy_redirect http://localhost:8000/two/ http://frontend/one/; 684 proxy_redirect http://localhost:8000/two/ http://frontend/one/;
685 </example> 685 </example>
686 перепишет эту строку в виде 686 перепишет эту строку в виде
687 “<literal>Location: http://frontend/one/some/uri/</literal>”. 687 “<literal>Location: http://frontend/one/some/uri/</literal>”.
688 </para> 688 </para>
689 689
690 <para> 690 <para>
691 В заменяемой строке можно не указывать имя сервера: 691 В заменяемой строке можно не указывать имя сервера:
692 <example> 692 <example>
693 proxy_redirect http://localhost:8000/two/ /; 693 proxy_redirect http://localhost:8000/two/ /;
694 </example> 694 </example>
695 тогда будет подставлено основное имя сервера и порт, если он отличен от 80. 695 тогда будет подставлено основное имя сервера и порт, если он отличен от 80.
696 </para> 696 </para>
697 697
698 <para> 698 <para>
717 </para> 717 </para>
718 718
719 <para> 719 <para>
720 В строке <value>замена</value> можно использовать переменные: 720 В строке <value>замена</value> можно использовать переменные:
721 <example> 721 <example>
722 proxy_redirect http://localhost:8000/ http://$host:$server_port/; 722 proxy_redirect http://localhost:8000/ http://$host:$server_port/;
723 </example> 723 </example>
724 </para> 724 </para>
725 725
726 <para> 726 <para>
727 В строке <value>перенаправление</value> тоже можно использовать (1.1.11) 727 В строке <value>перенаправление</value> тоже можно использовать (1.1.11)
728 переменные: 728 переменные:
729 <example> 729 <example>
730 proxy_redirect http://$proxy_host:8000/ /; 730 proxy_redirect http://$proxy_host:8000/ /;
731 </example> 731 </example>
732 </para> 732 </para>
733 733
734 <para> 734 <para>
735 Директиву также можно задать (1.1.11) при помощи регулярных выражений. 735 Директиву также можно задать (1.1.11) при помощи регулярных выражений.
738 либо с символов “<literal>~*</literal>”, если регистр символов учитывать 738 либо с символов “<literal>~*</literal>”, если регистр символов учитывать
739 не нужно. 739 не нужно.
740 Регулярное выражение может содержать именованные и позиционные выделения, 740 Регулярное выражение может содержать именованные и позиционные выделения,
741 а <value>замена</value> ссылаться на них: 741 а <value>замена</value> ссылаться на них:
742 <example> 742 <example>
743 proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2; 743 proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2;
744 proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2; 744 proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2;
745 </example> 745 </example>
746 </para> 746 </para>
747 747
748 <para> 748 <para>
749 Директив <literal>proxy_redirect</literal> может быть несколько: 749 Директив <literal>proxy_redirect</literal> может быть несколько:
750 <example> 750 <example>
751 proxy_redirect default; 751 proxy_redirect default;
752 proxy_redirect http://localhost:8000/ /; 752 proxy_redirect http://localhost:8000/ /;
753 proxy_redirect http://www.example.com/ /; 753 proxy_redirect http://www.example.com/ /;
754 </example> 754 </example>
755 </para> 755 </para>
756 756
757 <para> 757 <para>
758 Параметр <literal>off</literal> запрещает все директивы 758 Параметр <literal>off</literal> запрещает все директивы
759 <literal>proxy_redirect</literal> 759 <literal>proxy_redirect</literal>
760 на данном уровне: 760 на данном уровне:
761 <example> 761 <example>
762 proxy_redirect off; 762 proxy_redirect off;
763 proxy_redirect default; 763 proxy_redirect default;
764 proxy_redirect http://localhost:8000/ /; 764 proxy_redirect http://localhost:8000/ /;
765 proxy_redirect http://www.example.com/ /; 765 proxy_redirect http://www.example.com/ /;
766 </example> 766 </example>
767 </para> 767 </para>
768 768
769 <para> 769 <para>
770 С помощью этой директивы можно также добавлять имя хоста к относительным 770 С помощью этой директивы можно также добавлять имя хоста к относительным
771 перенаправлениям, выдаваемым проксируемым сервером: 771 перенаправлениям, выдаваемым проксируемым сервером:
772 <example> 772 <example>
773 proxy_redirect / /; 773 proxy_redirect / /;
774 </example> 774 </example>
775 </para> 775 </para>
776 776
777 </directive> 777 </directive>
778 778