Mercurial > hg > nginx-site
comparison xml/en/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="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 |