comparison xml/ru/docs/http/ngx_http_uwsgi_module.xml @ 1192:b5268820c3f3

Documented "suwsgi" protocol support.
author Ruslan Ermilov <ru@nginx.com>
date Sat, 17 May 2014 01:55:12 +0400
parents ea85ba147fe9
children 0320929f8544
comparison
equal deleted inserted replaced
1191:ea85ba147fe9 1192:b5268820c3f3
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_uwsgi_module" 10 <module name="Модуль ngx_http_uwsgi_module"
11 link="/ru/docs/http/ngx_http_uwsgi_module.html" 11 link="/ru/docs/http/ngx_http_uwsgi_module.html"
12 lang="ru" 12 lang="ru"
13 rev="1"> 13 rev="2">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 Модуль <literal>ngx_http_uwsgi_module</literal> позволяет передавать 18 Модуль <literal>ngx_http_uwsgi_module</literal> позволяет передавать
805 805
806 </directive> 806 </directive>
807 807
808 808
809 <directive name="uwsgi_pass"> 809 <directive name="uwsgi_pass">
810 <syntax><value>адрес</value></syntax> 810 <syntax>[<value>протокол</value>://]<value>адрес</value></syntax>
811 <default/> 811 <default/>
812 <context>location</context> 812 <context>location</context>
813 <context>if в location</context> 813 <context>if в location</context>
814 814
815 <para> 815 <para>
816 Задаёт адрес uwsgi-сервера. 816 Задаёт протокол и адрес uwsgi-сервера.
817 В качестве протокола можно указать
818 “<literal>uwsgi</literal>” или “<literal>suwsgi</literal>”
819 (secured uwsgi, uwsgi через SSL).
817 Адрес может быть указан в виде доменного имени или адреса, и порта, например, 820 Адрес может быть указан в виде доменного имени или адреса, и порта, например,
818 <example> 821 <example>
819 uwsgi_pass localhost:9000; 822 uwsgi_pass localhost:9000;
823 uwsgi_pass uwsgi://localhost:9000;
824 uwsgi_pass suwsgi://[2001:db8::1]:9090;
820 </example> 825 </example>
821 или в виде пути UNIX-сокета: 826 или в виде пути UNIX-сокета:
822 <example> 827 <example>
823 uwsgi_pass unix:/tmp/uwsgi.socket; 828 uwsgi_pass unix:/tmp/uwsgi.socket;
824 </example> 829 </example>
827 <para> 832 <para>
828 Если доменному имени соответствует несколько адресов, то все они будут 833 Если доменному имени соответствует несколько адресов, то все они будут
829 использоваться по очереди (round-robin). 834 использоваться по очереди (round-robin).
830 И, кроме того, адрес может быть 835 И, кроме того, адрес может быть
831 <link doc="ngx_http_upstream_module.xml">группой серверов</link>. 836 <link doc="ngx_http_upstream_module.xml">группой серверов</link>.
837 </para>
838
839 <para>
840 <note>
841 Протокол secured uwsgi поддерживается начиная с версии 1.5.8.
842 </note>
832 </para> 843 </para>
833 844
834 </directive> 845 </directive>
835 846
836 847
910 Задаёт таймаут при передаче запроса uwsgi-серверу. 921 Задаёт таймаут при передаче запроса uwsgi-серверу.
911 Таймаут устанавливается не на всю передачу запроса, 922 Таймаут устанавливается не на всю передачу запроса,
912 а только между двумя операциями записи. 923 а только между двумя операциями записи.
913 Если по истечении этого времени uwsgi-сервер не примет новых данных, 924 Если по истечении этого времени uwsgi-сервер не примет новых данных,
914 соединение закрывается. 925 соединение закрывается.
926 </para>
927
928 </directive>
929
930
931 <directive name="uwsgi_ssl_ciphers">
932 <syntax><value>ciphers</value></syntax>
933 <default>DEFAULT</default>
934 <context>http</context>
935 <context>server</context>
936 <context>location</context>
937 <appeared-in>1.5.8</appeared-in>
938
939 <para>
940 Описывает разрешённые шифры для запросов к suwsgi-серверу.
941 Шифры задаются в формате, поддерживаемом библиотекой OpenSSL.
942 </para>
943
944 <para>
945 Полный список можно посмотреть с помощью команды
946 “<command>openssl ciphers</command>”.
947 </para>
948
949 </directive>
950
951
952 <directive name="uwsgi_ssl_protocols">
953 <syntax>
954 [<literal>SSLv2</literal>]
955 [<literal>SSLv3</literal>]
956 [<literal>TLSv1</literal>]
957 [<literal>TLSv1.1</literal>]
958 [<literal>TLSv1.2</literal>]</syntax>
959 <default>SSLv3 TLSv1 TLSv1.1 TLSv1.2</default>
960 <context>http</context>
961 <context>server</context>
962 <context>location</context>
963 <appeared-in>1.5.8</appeared-in>
964
965 <para>
966 Разрешает указанные протоколы для запросов к suwsgi-серверу.
967 </para>
968
969 </directive>
970
971
972 <directive name="uwsgi_ssl_session_reuse">
973 <syntax><literal>on</literal> | <literal>off</literal></syntax>
974 <default>on</default>
975 <context>http</context>
976 <context>server</context>
977 <context>location</context>
978 <appeared-in>1.5.8</appeared-in>
979
980 <para>
981 Определяет, использовать ли повторно SSL-сессии при
982 работе с suwsgi-сервером.
983 Если в логах появляются ошибки
984 “<literal>SSL3_GET_FINISHED:digest check failed</literal>”,
985 то можно попробовать выключить
986 повторное использование сессий.
915 </para> 987 </para>
916 988
917 </directive> 989 </directive>
918 990
919 991