Mercurial > hg > nginx-site

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

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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="Module ngx_http_uwsgi_module" 10 <module name="Module ngx_http_uwsgi_module"
11 link="/en/docs/http/ngx_http_uwsgi_module.html" 11 link="/en/docs/http/ngx_http_uwsgi_module.html"
12 lang="en" 12 lang="en"
13 rev="1"> 13 rev="2">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 The <literal>ngx_http_uwsgi_module</literal> module allows passing 18 The <literal>ngx_http_uwsgi_module</literal> module allows passing
812 812
813 </directive> 813 </directive>
814 814
815 815
816 <directive name="uwsgi_pass"> 816 <directive name="uwsgi_pass">
817 <syntax><value>address</value></syntax> 817 <syntax>[<value>protocol</value>://]<value>address</value></syntax>
818 <default/> 818 <default/>
819 <context>location</context> 819 <context>location</context>
820 <context>if in location</context> 820 <context>if in location</context>
821 821
822 <para> 822 <para>
823 Sets the address of a uwsgi server. 823 Sets the protocol and address of a uwsgi server.
824 As a <value>protocol</value>,
825 “<literal>uwsgi</literal>” or “<literal>suwsgi</literal>”
826 (secured uwsgi, uwsgi over SSL) can be specified.
824 The address can be specified as a domain name or IP address, 827 The address can be specified as a domain name or IP address,
825 and an optional port: 828 and an optional port:
826 <example> 829 <example>
827 uwsgi_pass localhost:9000; 830 uwsgi_pass localhost:9000;
831 uwsgi_pass uwsgi://localhost:9000;
832 uwsgi_pass suwsgi://[2001:db8::1]:9090;
828 </example> 833 </example>
829 or as a UNIX-domain socket path: 834 or as a UNIX-domain socket path:
830 <example> 835 <example>
831 uwsgi_pass unix:/tmp/uwsgi.socket; 836 uwsgi_pass unix:/tmp/uwsgi.socket;
832 </example> 837 </example>
835 <para> 840 <para>
836 If a domain name resolves to several addresses, all of them will be 841 If a domain name resolves to several addresses, all of them will be
837 used in a round-robin fashion. 842 used in a round-robin fashion.
838 In addition, an address can be specified as a 843 In addition, an address can be specified as a
839 <link doc="ngx_http_upstream_module.xml">server group</link>. 844 <link doc="ngx_http_upstream_module.xml">server group</link>.
845 </para>
846
847 <para>
848 <note>
849 Secured uwsgi protocol is supported since version 1.5.8.
850 </note>
840 </para> 851 </para>
841 852
842 </directive> 853 </directive>
843 854
844 855
918 Sets a timeout for transmitting a request to the uwsgi server. 929 Sets a timeout for transmitting a request to the uwsgi server.
919 The timeout is set only between two successive write operations, 930 The timeout is set only between two successive write operations,
920 not for the transmission of the whole request. 931 not for the transmission of the whole request.
921 If the uwsgi server does not receive anything within this time, 932 If the uwsgi server does not receive anything within this time,
922 the connection is closed. 933 the connection is closed.
934 </para>
935
936 </directive>
937
938
939 <directive name="uwsgi_ssl_ciphers">
940 <syntax><value>ciphers</value></syntax>
941 <default>DEFAULT</default>
942 <context>http</context>
943 <context>server</context>
944 <context>location</context>
945 <appeared-in>1.5.8</appeared-in>
946
947 <para>
948 Specifies the enabled ciphers for requests to a secured uwsgi server.
949 The ciphers are specified in the format understood by the OpenSSL library.
950 </para>
951
952 <para>
953 The full list can be viewed using the
954 “<command>openssl ciphers</command>” command.
955 </para>
956
957 </directive>
958
959
960 <directive name="uwsgi_ssl_protocols">
961 <syntax>
962 [<literal>SSLv2</literal>]
963 [<literal>SSLv3</literal>]
964 [<literal>TLSv1</literal>]
965 [<literal>TLSv1.1</literal>]
966 [<literal>TLSv1.2</literal>]</syntax>
967 <default>SSLv3 TLSv1 TLSv1.1 TLSv1.2</default>
968 <context>http</context>
969 <context>server</context>
970 <context>location</context>
971 <appeared-in>1.5.8</appeared-in>
972
973 <para>
974 Enables the specified protocols for requests to a secured uwsgi server.
975 </para>
976
977 </directive>
978
979
980 <directive name="uwsgi_ssl_session_reuse">
981 <syntax><literal>on</literal> | <literal>off</literal></syntax>
982 <default>on</default>
983 <context>http</context>
984 <context>server</context>
985 <context>location</context>
986 <appeared-in>1.5.8</appeared-in>
987
988 <para>
989 Determines whether SSL sessions can be reused when working with
990 a secured uwsgi server.
991 If the errors
992 “<literal>SSL3_GET_FINISHED:digest check failed</literal>”
993 appear in the logs, try disabling session reuse.
923 </para> 994 </para>
924 995
925 </directive> 996 </directive>
926 997
927 998