Mercurial > hg > nginx-site
annotate xml/en/docs/http/ngx_http_proxy_module.xml @ 426:1d6dc85ed324
Specifying "ignore_invalid_headers" or "underscores_in_headers" on the
server level in a default server affects all virtual servers listening
on the same address:port.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Mon, 27 Feb 2012 10:36:08 +0000 |
parents | cbc2d1b51cb6 |
children | 695f83494c19 |
rev | line source |
---|---|
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1 <?xml version="1.0"?> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
2 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
4 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
5 <module name="Module ngx_http_proxy_module" |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
6 link="/en/docs/http/ngx_http_proxy_module.html" |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
7 lang="en"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
8 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
9 <section id="summary"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
10 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
11 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
12 The <literal>ngx_http_proxy_module</literal> module allows to pass |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
13 requests to another server. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
14 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
15 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
16 </section> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
17 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
18 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
19 <section id="example" name="Example Configuration"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
20 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
21 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
22 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
23 location / { |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
24 proxy_pass http://localhost:8000; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
25 proxy_set_header Host $host; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
26 proxy_set_header X-Real-IP $remote_addr; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
27 } |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
28 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
29 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
30 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
31 </section> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
32 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
33 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
34 <section id="directives" name="Directives"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
35 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
36 <directive name="proxy_buffer_size"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
37 <syntax><value>size</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
38 <default>4k|8k</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
39 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
40 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
41 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
42 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
43 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
44 Sets <value>size</value> of the buffer used for reading the first part |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
45 of a response received from the proxied server. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
46 This part usually contains a small response header. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
47 By default, the buffer size is equal to the size of one |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
48 buffer set by the <link id="proxy_buffers"/> directive. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
49 It can be made smaller however. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
50 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
51 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
52 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
53 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
54 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
55 <directive name="proxy_buffering"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
56 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
57 <default>on</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
58 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
59 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
60 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
61 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
62 <para> |
405
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
63 Enables or disables buffering of responses from the proxied server. |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
64 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
65 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
66 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
67 When buffering is enabled, nginx receives a response from the proxied server |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
68 as soon as possible, saving it into buffers set by the |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
69 <link id="proxy_buffer_size"/> and <link id="proxy_buffers"/> directives. |
405
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
70 If the whole response does not fit into memory, part of it can be saved |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
71 to a <link id="proxy_temp_path">temporary file</link> on disk. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
72 Writes to temporary files are controlled by the |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
73 <link id="proxy_max_temp_file_size"/> and |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
74 <link id="proxy_temp_file_write_size"/> directives. |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
75 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
76 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
77 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
78 When buffering is disabled, a response is passed to a client synchronously, |
362 | 79 immediately as it is received. |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
80 nginx will not try to read the whole response from the proxied server. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
81 The maximum size of the data that nginx can receive from the server |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
82 at a time is set by the <link id="proxy_buffer_size"/> directive. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
83 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
84 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
85 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
86 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
87 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
88 <directive name="proxy_buffers"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
89 <syntax><value>number</value> <value>size</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
90 <default>8 4k|8k</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
91 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
92 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
93 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
94 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
95 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
96 Sets the <value>number</value> and <value>size</value> of |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
97 buffers used for reading a response from the proxied server, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
98 for a single connection. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
99 By default, the buffer size is equal to one memory page. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
100 This is either 4K or 8K, depending on a platform. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
101 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
102 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
103 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
104 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
105 |
405
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
106 <directive name="proxy_busy_buffers_size"> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
107 <syntax><value>size</value></syntax> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
108 <default>8k|16k</default> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
109 <context>http</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
110 <context>server</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
111 <context>location</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
112 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
113 <para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
114 When <link id="proxy_buffering">buffering</link> of responses from the proxied |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
115 server is enabled, limits the total <value>size</value> of buffers that |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
116 can be busy sending a response to the client while the response is not |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
117 yet fully read. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
118 In the mean time, the rest of the buffers can be used for reading a response |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
119 and, if needed, buffering part of a response to a temporary file. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
120 By default, <value>size</value> is limited by two buffers set by the |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
121 <link id="proxy_buffer_size"/> and <link id="proxy_buffers"/> directives. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
122 </para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
123 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
124 </directive> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
125 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
126 |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
127 <directive name="proxy_cache"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
128 <syntax><value>zone</value> | <literal>off</literal></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
129 <default>off</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
130 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
131 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
132 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
133 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
134 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
135 Defines a zone used for caching. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
136 The same zone can be used in several places. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
137 The <literal>off</literal> parameter disables caching inherited |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
138 from the previous configuration level. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
139 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
140 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
141 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
142 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
143 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
144 <directive name="proxy_cache_bypass"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
145 <syntax><value>string</value> ...</syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
146 <default/> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
147 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
148 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
149 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
150 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
151 <para> |
294 | 152 Defines conditions under which the response will not be taken from a cache. |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
153 If at least one value of the string parameters is not empty and is not |
294 | 154 equal to “0” then the response will not be taken from the cache: |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
155 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
156 proxy_cache_bypass $cookie_nocache $arg_nocache$arg_comment; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
157 proxy_cache_bypass $http_pragma $http_authorization; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
158 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
159 Can be used along with the <link id="proxy_no_cache"/> directive. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
160 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
161 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
162 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
163 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
164 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
165 <directive name="proxy_cache_key"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
166 <syntax><value>string</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
167 <default>$scheme$proxy_host$request_uri</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
168 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
169 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
170 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
171 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
172 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
173 Defines a key for caching, for example |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
174 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
175 proxy_cache_key "$host$request_uri $cookie_user"; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
176 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
177 By default, the directive’s value is close to the string |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
178 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
179 proxy_cache_key $scheme$proxy_host$uri$is_args$args; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
180 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
181 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
182 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
183 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
184 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
185 |
302
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
186 <directive name="proxy_cache_lock"> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
187 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
188 <default>off</default> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
189 <context>http</context> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
190 <context>server</context> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
191 <context>location</context> |
310
86732337c730
Added a historical information for proxy_cache_lock, proxy_cache_lock_timeout,
Ruslan Ermilov <ru@nginx.com>
parents:
302
diff
changeset
|
192 <appeared-in>1.1.12</appeared-in> |
302
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
193 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
194 <para> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
195 When enabled, only one request at a time will be allowed to populate |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
196 a new cache element identified according to the <link id="proxy_cache_key"/> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
197 directive by passing a request to a proxied server. |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
198 Other requests of the same cache element will either wait |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
199 for a response to appear in the cache, or the cache lock for |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
200 this element to be released, up to the time set by the |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
201 <link id="proxy_cache_lock_timeout"/> directive. |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
202 </para> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
203 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
204 </directive> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
205 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
206 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
207 <directive name="proxy_cache_lock_timeout"> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
208 <syntax><value>time</value></syntax> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
209 <default>5s</default> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
210 <context>http</context> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
211 <context>server</context> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
212 <context>location</context> |
310
86732337c730
Added a historical information for proxy_cache_lock, proxy_cache_lock_timeout,
Ruslan Ermilov <ru@nginx.com>
parents:
302
diff
changeset
|
213 <appeared-in>1.1.12</appeared-in> |
302
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
214 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
215 <para> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
216 Sets a timeout for <link id="proxy_cache_lock"/>. |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
217 </para> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
218 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
219 </directive> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
220 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
297
diff
changeset
|
221 |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
222 <directive name="proxy_cache_min_uses"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
223 <syntax><value>number</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
224 <default>1</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
225 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
226 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
227 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
228 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
229 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
230 Sets the <value>number</value> of requests after which the response |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
231 will be cached. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
232 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
233 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
234 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
235 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
236 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
237 <directive name="proxy_cache_path"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
238 <syntax> |
364 | 239 <value>path</value> |
240 [<literal>levels</literal>=<value>levels</value>] | |
241 <literal>keys_zone</literal>=<value>name</value>:<value>size</value> | |
242 [<literal>inactive</literal>=<value>time</value>] | |
243 [<literal>max_size</literal>=<value>size</value>]</syntax> | |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
244 <default/> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
245 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
246 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
247 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
248 Sets path and other parameters of a cache. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
249 Cache data are stored in files. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
250 Both the key and file name in a cache are a result of |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
251 applying the MD5 function to the proxied URL. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
252 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
253 The <literal>levels</literal> parameter defines hierarchy levels of a cache. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
254 For example, in the following configuration |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
255 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
256 proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
257 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
258 file names in a cache will look like this: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
259 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
260 /data/nginx/cache/<emphasis>c</emphasis>/<emphasis>29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
261 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
262 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
263 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
264 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
265 A cached response is first written to a temporary file, then a file is renamed. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
266 Starting from version 0.8.9 temporary files and the cache can be put on |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
267 different file systems but be aware that in this case a file is copied |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
268 across two file systems instead of the cheap rename operation. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
269 It is thus recommended that for any given location both cache and a directory |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
270 holding temporary files set by the <link id="proxy_temp_path"/> directive |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
271 are put on the same file system. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
272 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
273 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
274 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
275 In addition, all active keys and information about data are stored |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
276 in a shared memory zone, whose <value>name</value> and <value>size</value> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
277 are configured by the <literal>keys_zone</literal> parameter. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
278 Cached data that are not accessed during the time specified by the |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
279 <literal>inactive</literal> parameter get removed from the cache |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
280 regardless of their freshness. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
281 By default, <literal>inactive</literal> is set to 10 minutes. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
282 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
283 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
284 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
285 The special process “cache manager” monitors the maximum cache size set |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
286 by the <literal>max_size</literal> parameter; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
287 when this size is exceeded it removes the least recently used data. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
288 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
289 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
290 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
291 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
292 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
293 <directive name="proxy_cache_use_stale"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
294 <syntax> |
364 | 295 <literal>error</literal> | |
296 <literal>timeout</literal> | | |
297 <literal>invalid_header</literal> | | |
298 <literal>updating</literal> | | |
299 <literal>http_500</literal> | | |
300 <literal>http_502</literal> | | |
301 <literal>http_503</literal> | | |
302 <literal>http_504</literal> | | |
303 <literal>http_404</literal> | | |
304 <literal>off</literal> | |
305 ...</syntax> | |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
306 <default>off</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
307 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
308 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
309 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
310 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
311 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
312 If an error occurs while working with the proxied server it is possible |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
313 to use a stale cached response. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
314 This directives determines in which cases it is permitted. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
315 The directive’s parameters match those of the |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
316 <link id="proxy_next_upstream"/> directive. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
317 Additionally, the <literal>updating</literal> parameter permits |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
318 to use a stale cached response if it is currently being updated. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
319 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
320 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
321 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
322 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
323 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
324 <directive name="proxy_cache_valid"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
325 <syntax>[<value>code</value> ...] <value>time</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
326 <default/> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
327 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
328 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
329 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
330 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
331 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
332 Sets caching time for different response codes. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
333 For example, the following directives |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
334 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
335 proxy_cache_valid 200 302 10m; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
336 proxy_cache_valid 404 1m; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
337 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
338 set 10 minutes of caching for responses with codes 200 and 302, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
339 and 1 minute for responses with code 404. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
340 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
341 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
342 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
343 If only caching <value>time</value> is specified |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
344 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
345 proxy_cache_valid 5m; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
346 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
347 then only 200, 301, and 302 responses are cached. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
348 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
349 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
350 <para> |
294 | 351 In addition, it can be specified to cache any responses using the |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
352 <literal>any</literal> parameter: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
353 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
354 proxy_cache_valid 200 302 10m; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
355 proxy_cache_valid 301 1h; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
356 proxy_cache_valid any 1m; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
357 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
358 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
359 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
360 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
361 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
362 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
363 <directive name="proxy_connect_timeout"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
364 <syntax><value>time</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
365 <default>60s</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
366 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
367 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
368 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
369 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
370 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
371 Defines a timeout for establishing a connection with the proxied server. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
372 It should be noted that this timeout cannot usually exceed 75 seconds. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
373 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
374 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
375 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
376 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
377 |
417
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
378 <directive name="proxy_cookie_domain"> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
379 <syntax><literal>off</literal></syntax> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
380 <syntax><value>domain</value> <value>replacement</value></syntax> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
381 <default>off</default> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
382 <context>http</context> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
383 <context>server</context> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
384 <context>location</context> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
385 <appeared-in>1.1.15</appeared-in> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
386 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
387 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
388 Sets a text that should be changed in the <literal>domain</literal> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
389 attribute of the <header>Set-Cookie</header> header fields of a |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
390 proxied server response. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
391 Suppose a proxied server returned the header field |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
392 <header>Set-Cookie</header> with the attribute |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
393 “<literal>domain=localhost</literal>”. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
394 The directive |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
395 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
396 proxy_cookie_domain localhost example.org; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
397 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
398 will rewrite this attribute to |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
399 “<literal>domain=example.org</literal>”. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
400 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
401 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
402 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
403 A dot at the beginning of the <value>domain</value> and |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
404 <value>replacement</value> strings, and the <literal>domain</literal> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
405 attribute is ignored. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
406 Matching is case-insensitive. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
407 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
408 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
409 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
410 The strings <value>domain</value> and <value>replacement</value> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
411 can contain variables: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
412 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
413 proxy_cookie_domain www.$host $host; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
414 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
415 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
416 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
417 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
418 A directive can also be specified using regular expressions. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
419 In this case, <value>domain</value> should start from |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
420 the “<literal>~</literal>” symbol. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
421 A regular expression can contain named and positional captures, |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
422 and <value>replacement</value> can reference them: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
423 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
424 proxy_cookie_domain ~\.(?P<sl_domain>[-0-9a-z]+\.[a-z]+)$ $sl_domain; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
425 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
426 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
427 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
428 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
429 There could be several <literal>proxy_cookie_domain</literal> directives: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
430 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
431 proxy_cookie_domain localhost example.org; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
432 proxy_cookie_domain ~\.([a-z]+\.[a-z]+)$ $1; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
433 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
434 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
435 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
436 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
437 The <literal>off</literal> parameter cancels all |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
438 <literal>proxy_cookie_domain</literal> directives on the current level: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
439 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
440 proxy_cookie_domain off; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
441 proxy_cookie_domain localhost example.org; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
442 proxy_cookie_domain www.example.org example.org; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
443 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
444 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
445 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
446 </directive> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
447 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
448 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
449 <directive name="proxy_cookie_path"> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
450 <syntax><literal>off</literal></syntax> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
451 <syntax><value>path</value> <value>replacement</value></syntax> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
452 <default>off</default> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
453 <context>http</context> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
454 <context>server</context> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
455 <context>location</context> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
456 <appeared-in>1.1.15</appeared-in> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
457 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
458 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
459 Sets a text that should be changed in the <literal>path</literal> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
460 attribute of the <header>Set-Cookie</header> header fields of a |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
461 proxied server response. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
462 Suppose a proxied server returned the header field |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
463 <header>Set-Cookie</header> with the attribute |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
464 “<literal>path=/two/some/uri/</literal>”. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
465 The directive |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
466 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
467 proxy_cookie_path /two/ /; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
468 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
469 will rewrite this attribute to |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
470 “<literal>path=/some/uri/</literal>”. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
471 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
472 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
473 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
474 The strings <value>path</value> and <value>replacement</value> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
475 can contain variables: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
476 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
477 proxy_cookie_path $uri /some$uri; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
478 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
479 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
480 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
481 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
482 A directive can also be specified using regular expressions. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
483 In this case, <value>path</value> should either start from |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
484 the “<literal>~</literal>” symbol for a case-sensitive matching, |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
485 or from the “<literal>~*</literal>” symbols for case-insensitive |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
486 matching. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
487 A regular expression can contain named and positional captures, |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
488 and <value>replacement</value> can reference them: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
489 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
490 proxy_cookie_path ~*^/user/([^/]+) /u/$1; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
491 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
492 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
493 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
494 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
495 There could be several <literal>proxy_cookie_path</literal> directives: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
496 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
497 proxy_cookie_path /one/ /; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
498 proxy_cookie_path / /two/; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
499 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
500 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
501 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
502 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
503 The <literal>off</literal> parameter cancels all |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
504 <literal>proxy_cookie_path</literal> directives on the current level: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
505 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
506 proxy_cookie_path off; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
507 proxy_cookie_path /two/ /; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
508 proxy_cookie_path ~*^/user/([^/]+) /u/$1; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
509 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
510 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
511 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
512 </directive> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
513 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
514 |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
515 <directive name="proxy_hide_header"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
516 <syntax><value>field</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
517 <default/> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
518 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
519 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
520 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
521 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
522 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
523 By default, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
524 nginx does not pass the header fields <header>Date</header>, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
525 <header>Server</header>, <header>X-Pad</header>, and |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
526 <header>X-Accel-...</header> from the response of a proxied |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
527 server to a client. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
528 The <literal>proxy_hide_header</literal> directive sets additional fields |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
529 that will not be passed. |
294 | 530 If, on the contrary, the passing of fields needs to be permitted, |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
531 the <link id="proxy_pass_header"/> directive can be used. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
532 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
533 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
534 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
535 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
536 |
316
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
537 <directive name="proxy_http_version"> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
538 <syntax><literal>1.0</literal> | <literal>1.1</literal></syntax> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
539 <default>1.0</default> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
540 <context>http</context> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
541 <context>server</context> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
542 <context>location</context> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
543 <appeared-in>1.1.4</appeared-in> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
544 |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
545 <para> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
546 Sets the HTTP protocol version for proxying. |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
547 By default, version 1.0 is used. |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
548 Version 1.1 is recommended for use with |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
549 <link doc="ngx_http_upstream_module.xml" id="keepalive"/> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
550 connections. |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
551 </para> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
552 |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
553 </directive> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
554 |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
555 |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
556 <directive name="proxy_ignore_client_abort"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
557 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
558 <default>off</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
559 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
560 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
561 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
562 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
563 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
564 Determines should the connection with a proxied server be |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
565 closed if a client closes a connection without waiting |
294 | 566 for a response. |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
567 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
568 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
569 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
570 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
571 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
572 <directive name="proxy_ignore_headers"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
573 <syntax><value>field</value> ...</syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
574 <default/> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
575 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
576 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
577 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
578 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
579 <para> |
294 | 580 Disables processing of certain response header fields from the proxied server. |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
581 The following fields can be ignored: <header>X-Accel-Redirect</header>, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
582 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6), |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
583 <header>X-Accel-Buffering</header> (1.1.6), |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
584 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
585 <header>Cache-Control</header>, and <header>Set-Cookie</header> (0.8.44). |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
586 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
587 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
588 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
589 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
590 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
591 <directive name="proxy_intercept_errors"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
592 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
593 <default>off</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
594 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
595 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
596 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
597 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
598 <para> |
297 | 599 Determines whether proxied responses with codes greater than or equal |
600 to 400 should be passed to a client or be redirected to nginx for processing | |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
601 using the <link doc="ngx_http_core_module.xml" id="error_page"/> directive. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
602 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
603 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
604 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
605 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
606 |
405
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
607 <directive name="proxy_max_temp_file_size"> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
608 <syntax><value>size</value></syntax> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
609 <default>1024m</default> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
610 <context>http</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
611 <context>server</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
612 <context>location</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
613 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
614 <para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
615 When <link id="proxy_buffering">buffering</link> of responses from the proxied |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
616 server is enabled, and the whole response does not fit into memory buffers |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
617 set by the <link id="proxy_buffer_size"/> and <link id="proxy_buffers"/> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
618 directives, part of a response can be saved to a temporary file. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
619 This directive sets the maximum <value>size</value> of a temporary file. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
620 The size of data written to a temporary file at a time is set |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
621 by the <link id="proxy_temp_file_write_size"/> directive. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
622 </para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
623 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
624 <para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
625 Value of zero disables buffering of responses to temporary files. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
626 </para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
627 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
628 </directive> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
629 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
630 |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
631 <directive name="proxy_next_upstream"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
632 <syntax> |
364 | 633 <literal>error</literal> | |
634 <literal>timeout</literal> | | |
635 <literal>invalid_header</literal> | | |
636 <literal>http_500</literal> | | |
637 <literal>http_502</literal> | | |
638 <literal>http_503</literal> | | |
639 <literal>http_504</literal> | | |
640 <literal>http_404</literal> | | |
641 <literal>off</literal> | |
642 ...</syntax> | |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
643 <default>error timeout</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
644 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
645 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
646 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
647 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
648 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
649 Specifies in which cases a request should be passed to the next server: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
650 <list type="tag"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
651 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
652 <tag-name><literal>error</literal></tag-name> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
653 <tag-desc>an error occurred while establishing a connection with the |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
654 server, passing it a request, or reading the response header;</tag-desc> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
655 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
656 <tag-name><literal>timeout</literal></tag-name> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
657 <tag-desc>a timeout has occurred while establishing a connection with the |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
658 server, passing it a request, or reading the response header;</tag-desc> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
659 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
660 <tag-name><literal>invalid_header</literal></tag-name> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
661 <tag-desc>a server returned empty or invalid response;</tag-desc> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
662 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
663 <tag-name><literal>http_500</literal></tag-name> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
664 <tag-desc>a server returned a response with the code 500;</tag-desc> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
665 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
666 <tag-name><literal>http_502</literal></tag-name> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
667 <tag-desc>a server returned a response with the code 502;</tag-desc> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
668 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
669 <tag-name><literal>http_503</literal></tag-name> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
670 <tag-desc>a server returned a response with the code 503;</tag-desc> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
671 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
672 <tag-name><literal>http_504</literal></tag-name> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
673 <tag-desc>a server returned a response with the code 504;</tag-desc> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
674 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
675 <tag-name><literal>http_404</literal></tag-name> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
676 <tag-desc>a server returned a response with the code 404;</tag-desc> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
677 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
678 <tag-name><literal>off</literal></tag-name> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
679 <tag-desc>disables passing a request to the next server.</tag-desc> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
680 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
681 </list> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
682 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
683 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
684 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
685 It should be understood that passing a request to the next server is |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
686 only possible if a client was not sent anything yet. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
687 That is, if an error or a timeout occurs in the middle of |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
688 transferring a response, fixing this is impossible. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
689 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
690 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
691 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
692 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
693 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
694 <directive name="proxy_no_cache"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
695 <syntax><value>string</value> ...</syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
696 <default/> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
697 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
698 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
699 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
700 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
701 <para> |
294 | 702 Defines conditions under which the response will not be saved to a cache. |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
703 If at least one value of the string parameters is not empty and is not |
294 | 704 equal to “0” then the response will not be saved: |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
705 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
706 proxy_no_cache $cookie_nocache $arg_nocache$arg_comment; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
707 proxy_no_cache $http_pragma $http_authorization; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
708 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
709 Can be used along with the <link id="proxy_cache_bypass"/> directive. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
710 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
711 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
712 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
713 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
714 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
715 <directive name="proxy_pass"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
716 <syntax><value>URL</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
717 <default/> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
718 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
719 <context>if in location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
720 <context>limit_except</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
721 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
722 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
723 Sets an address of the proxied server and a URI that maps a location. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
724 An address can be specified as a domain name or an address, and a port, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
725 for example, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
726 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
727 proxy_pass http://localhost:8000/uri/; |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
728 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
729 or as a UNIX-domain socket path: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
730 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
731 proxy_pass http://unix:/tmp/backend.socket:/uri/; |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
732 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
733 here a path is specified after the word “<literal>unix</literal>” |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
734 and enclosed in two colons. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
735 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
736 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
737 <para> |
294 | 738 If a domain name resolves to several addresses, all of them will be |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
739 used in a round-robin fashion. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
740 In addition, an address can be specified as a |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
741 <link doc="ngx_http_upstream_module.xml">server group</link>. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
742 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
743 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
744 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
745 When passing a request to the server, part of a URI matching the location |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
746 is replaced by a URI specified in the <literal>proxy_pass</literal> directive. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
747 This rule has two exceptions where a replacement location cannot be |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
748 defined: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
749 <list type="bullet"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
750 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
751 <listitem> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
752 when a location is specified using a regular expression; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
753 </listitem> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
754 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
755 <listitem> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
756 if a URI is changed using the |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
757 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/> directive |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
758 inside a proxied location, and this same configuration will be |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
759 used to process a request (<literal>break</literal>): |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
760 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
761 location /name/ { |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
762 rewrite /name/([^/]+) /users?name=$1 break; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
763 proxy_pass http://127.0.0.1; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
764 } |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
765 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
766 In these cases a URI is passed without mapping. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
767 </listitem> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
768 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
769 </list> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
770 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
771 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
772 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
773 It can also be specified that a request URI should be passed unchanged, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
774 in the same form it was sent by the client, not the processed form. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
775 During a processing |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
776 <list type="bullet"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
777 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
778 <listitem> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
779 two or more adjacent slashes are replaced by one: “//” — “/”; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
780 </listitem> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
781 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
782 <listitem> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
783 links to the current directory get removed: “/./” — “/”; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
784 </listitem> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
785 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
786 <listitem> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
787 links to the parent directory get removed: “/dir/../” — “/”. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
788 </listitem> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
789 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
790 </list> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
791 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
792 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
793 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
794 If a URI should be passed unchanged then the server URL should be specified |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
795 without a URI in the <literal>proxy_pass</literal> directive: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
796 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
797 location /some/path/ { |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
798 proxy_pass http://127.0.0.1; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
799 } |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
800 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
801 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
802 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
803 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
804 Server name, its port, and passed URI can be specified using variables: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
805 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
806 proxy_pass http://$host$uri; |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
807 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
808 or like this: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
809 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
810 proxy_pass $request; |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
811 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
812 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
813 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
814 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
815 In this case the server name is searched among the described |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
816 <link doc="ngx_http_upstream_module.xml">server groups</link>, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
817 and if not found is determined using a |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
818 <link doc="ngx_http_core_module.xml" id="resolver"/>. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
819 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
820 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
821 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
822 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
823 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
824 <directive name="proxy_pass_header"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
825 <syntax><value>field</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
826 <default/> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
827 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
828 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
829 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
830 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
831 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
832 Permits to pass <link id="proxy_hide_header">otherwise disabled</link> header |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
833 fields from a proxied server to a client. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
834 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
835 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
836 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
837 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
838 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
839 <directive name="proxy_read_timeout"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
840 <syntax><value>time</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
841 <default>60s</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
842 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
843 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
844 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
845 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
846 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
847 Defines a timeout for reading a response from the proxied server. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
848 A timeout is only set between two successive read operations, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
849 not for the transmission of the whole response. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
850 If a proxied server does not transmit anything within this time, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
851 a connection is closed. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
852 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
853 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
854 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
855 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
856 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
857 <directive name="proxy_redirect"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
858 <syntax><literal>default</literal></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
859 <syntax><literal>off</literal></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
860 <syntax><value>redirect</value> <value>replacement</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
861 <default>default</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
862 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
863 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
864 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
865 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
866 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
867 Sets a text that should be changed in the header fields |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
868 <header>Location</header> and <header>Refresh</header> of a response |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
869 from the proxied server. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
870 Suppose a proxied server returned the header field |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
871 “<literal>Location: http://localhost:8000/two/some/uri/</literal>”. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
872 The directive |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
873 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
874 proxy_redirect http://localhost:8000/two/ http://frontend/one/; |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
875 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
876 will rewrite this string to |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
877 “<literal>Location: http://frontend/one/some/uri/</literal>”. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
878 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
879 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
880 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
881 A server name may be omitted from the <value>replacement</value> string: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
882 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
883 proxy_redirect http://localhost:8000/two/ /; |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
884 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
885 then the primary server’s name and a port, if different from 80, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
886 will be substituted. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
887 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
888 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
889 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
890 The default replacement specified by the <literal>default</literal> parameter |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
891 uses the parameters of the |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
892 <link doc="ngx_http_core_module.xml" id="location"/> and |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
893 <link id="proxy_pass"/> directives. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
894 Hence, the two configurations below are equivalent: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
895 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
896 location /one/ { |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
897 proxy_pass http://upstream:port/two/; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
898 proxy_redirect default; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
899 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
900 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
901 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
902 location /one/ { |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
903 proxy_pass http://upstream:port/two/; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
904 proxy_redirect http://upstream:port/two/ /one/; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
905 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
906 The <literal>default</literal> parameter is not permitted if |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
907 <link id="proxy_pass"/> is specified using variables. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
908 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
909 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
910 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
911 A <value>replacement</value> string can contain variables: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
912 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
913 proxy_redirect http://localhost:8000/ http://$host:$server_port/; |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
914 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
915 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
916 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
917 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
918 A <value>redirect</value> can also contain (1.1.11) variables: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
919 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
920 proxy_redirect http://$proxy_host:8000/ /; |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
921 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
922 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
923 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
924 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
925 A directive can be specified (1.1.11) using regular expressions. |
417
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
926 In this case, <value>redirect</value> should either start from |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
927 the “<literal>~</literal>” symbol for a case-sensitive matching, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
928 or from the “<literal>~*</literal>” symbols for case-insensitive |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
929 matching. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
930 A regular expression can contain named and positional captures, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
931 and <value>replacement</value> can reference them: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
932 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
933 proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
934 proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2; |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
935 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
936 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
937 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
938 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
939 There could be several <literal>proxy_redirect</literal> directives: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
940 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
941 proxy_redirect default; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
942 proxy_redirect http://localhost:8000/ /; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
943 proxy_redirect http://www.example.com/ /; |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
944 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
945 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
946 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
947 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
948 The <literal>off</literal> parameter cancels all |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
949 <literal>proxy_redirect</literal> directives on the current level: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
950 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
951 proxy_redirect off; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
952 proxy_redirect default; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
953 proxy_redirect http://localhost:8000/ /; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
954 proxy_redirect http://www.example.com/ /; |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
955 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
956 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
957 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
958 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
959 Using this directive it is also possible to add host names to relative |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
960 redirects issued by a proxied server: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
961 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
962 proxy_redirect / /; |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
963 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
964 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
965 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
966 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
967 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
968 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
969 <directive name="proxy_send_timeout"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
970 <syntax><value>time</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
971 <default>60s</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
972 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
973 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
974 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
975 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
976 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
977 Sets a timeout for transmitting a request to the proxied server. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
978 A timeout is only set between two successive write operations, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
979 not for the transmission of the whole request. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
980 If a proxied server does not receive anything within this time, |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
981 a connection is closed. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
982 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
983 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
984 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
985 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
986 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
987 <directive name="proxy_set_header"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
988 <syntax><value>field</value> <value>value</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
989 <default>Host $proxy_host</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
990 <default>Connection close</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
991 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
992 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
993 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
994 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
995 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
996 Allows to redefine or append fields to the request header |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
997 passed to the proxied server. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
998 A <value>value</value> can contain text, variables, and their combination. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
999 These directives are inherited from the previous level if and |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1000 only if there are no |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1001 <literal>proxy_set_header</literal> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1002 directives defined on the current level. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1003 By default, only two fields are redefined: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1004 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1005 proxy_set_header Host $proxy_host; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1006 proxy_set_header Connection close; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1007 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1008 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1009 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1010 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1011 An unchanged <header>Host</header> request header field can be passed like this: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1012 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1013 proxy_set_header Host $http_host; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1014 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1015 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1016 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1017 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1018 However, if this field is not present in a client request header then |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1019 nothing will be passed. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1020 In such a case it is better to use the <var>$host</var> variable—its |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1021 value equals the server name in the <header>Host</header> request header |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1022 field, or the primary server name if this field is not present: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1023 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1024 proxy_set_header Host $host; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1025 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1026 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1027 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1028 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1029 In addition, a server name can be passed together with a port of the |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1030 proxied server: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1031 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1032 proxy_set_header Host $host:$proxy_port; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1033 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1034 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1035 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1036 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1037 If the value of a header field is an empty string then this |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1038 field will not be passed to a proxied server: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1039 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1040 proxy_set_header Accept-Encoding ""; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1041 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1042 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1043 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1044 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1045 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1046 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1047 <directive name="proxy_ssl_session_reuse"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1048 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1049 <default>on</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1050 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1051 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1052 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1053 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1054 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1055 Determines whether SSL sessions can be reused when working with |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1056 the proxied server. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1057 If the errors |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1058 “<literal>SSL3_GET_FINISHED:digest check failed</literal>” |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1059 appear in the logs, try to disable session reuse. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1060 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1061 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1062 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1063 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1064 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1065 <directive name="proxy_store"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1066 <syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1067 <literal>on</literal> | |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1068 <literal>off</literal> | |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1069 <value>string</value></syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1070 <default>off</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1071 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1072 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1073 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1074 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1075 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1076 Enables saving of files to a disk. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1077 The <literal>on</literal> parameter saves files with paths |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1078 corresponding to the directives |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1079 <link doc="ngx_http_core_module.xml" id="alias"/> or |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1080 <link doc="ngx_http_core_module.xml" id="root"/>. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1081 The <literal>off</literal> parameter disables saving of files. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1082 In addition, the file name can be set explicitly using the |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1083 <value>string</value> with variables: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1084 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1085 proxy_store /data/www$original_uri; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1086 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1087 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1088 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1089 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1090 The modification time of files is set according to the received |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1091 <header>Last-Modified</header> response header field. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1092 A response is first written to a temporary file, then a file is renamed. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1093 Starting from version 0.8.9 temporary files and the persistent store |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1094 can be put on different file systems but be aware that in this case |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1095 a file is copied across two file systems instead of the cheap rename operation. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1096 It is thus recommended that for any given location both saved files and a |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1097 directory holding temporary files set by the <link id="proxy_temp_path"/> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1098 directive are put on the same file system. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1099 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1100 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1101 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1102 This directive can be used to create local copies of static unchangeable |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1103 files, e.g.: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1104 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1105 location /images/ { |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1106 root /data/www; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1107 open_file_cache_errors off; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1108 error_page 404 = /fetch$uri; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1109 } |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1110 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1111 location /fetch/ { |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1112 internal; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1113 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1114 proxy_pass http://backend/; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1115 proxy_store on; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1116 proxy_store_access user:rw group:rw all:r; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1117 proxy_temp_path /data/temp; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1118 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1119 alias /data/www/; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1120 } |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1121 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1122 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1123 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1124 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1125 or like this: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1126 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1127 location /images/ { |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1128 root /data/www; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1129 error_page 404 = @fetch; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1130 } |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1131 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1132 location @fetch { |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1133 internal; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1134 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1135 proxy_pass http://backend; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1136 proxy_store on; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1137 proxy_store_access user:rw group:rw all:r; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1138 proxy_temp_path /data/temp; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1139 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1140 root /data/www; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1141 } |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1142 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1143 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1144 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1145 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1146 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1147 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1148 <directive name="proxy_store_access"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1149 <syntax><value>users</value>:<value>permissions</value> ...</syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1150 <default>user:rw</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1151 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1152 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1153 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1154 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1155 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1156 Sets access permissions for newly created files and directories, e.g.: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1157 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1158 proxy_store_access user:rw group:rw all:r; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1159 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1160 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1161 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1162 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1163 If any <literal>group</literal> or <literal>all</literal> access permissions |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1164 are specified then <literal>user</literal> permissions may be omitted: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1165 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1166 proxy_store_access group:rw all:r; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1167 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1168 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1169 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1170 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1171 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1172 |
405
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1173 <directive name="proxy_temp_file_write_size"> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1174 <syntax><value>size</value></syntax> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1175 <default>8k|16k</default> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1176 <context>http</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1177 <context>server</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1178 <context>location</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1179 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1180 <para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1181 Limits the <value>size</value> of data written to a temporary file |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1182 at a time, when buffering of responses from the proxied server |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1183 to temporary files is enabled. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1184 By default, <value>size</value> is limited by two buffers set by the |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1185 <link id="proxy_buffer_size"/> and <link id="proxy_buffers"/> directives. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1186 The maximum size of a temporary file is set by the |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1187 <link id="proxy_max_temp_file_size"/> directive. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1188 </para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1189 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1190 </directive> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1191 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1192 |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1193 <directive name="proxy_temp_path"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1194 <syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1195 <value>path</value> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1196 [<value>level1</value> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1197 [<value>level2</value> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1198 [<value>level3</value>]]]</syntax> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1199 <default>proxy_temp</default> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1200 <context>http</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1201 <context>server</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1202 <context>location</context> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1203 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1204 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1205 Defines a directory for storing temporary files |
405
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1206 with data received from proxied servers. |
281
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1207 Up to three-level subdirectory hierarchy can be used underneath the specified |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1208 directory. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1209 For example, in the following configuration |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1210 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1211 proxy_temp_path /spool/nginx/proxy_temp 1 2; |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1212 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1213 a temporary file might look like this: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1214 <example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1215 /spool/nginx/proxy_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1216 </example> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1217 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1218 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1219 </directive> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1220 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1221 </section> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1222 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1223 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1224 <section id="variables" name="Embedded Variables"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1225 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1226 <para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1227 The <literal>ngx_http_proxy_module</literal> module supports embedded variables |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1228 that can be used to compose headers using the |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1229 <link id="proxy_set_header"/> directive: |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1230 <list type="tag"> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1231 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1232 <tag-name><var>$proxy_host</var></tag-name> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1233 <tag-desc>name and port of a proxied server;</tag-desc> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1234 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1235 <tag-name><var>$proxy_port</var></tag-name> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1236 <tag-desc>port of a proxied server;</tag-desc> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1237 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1238 <tag-name><var>$proxy_add_x_forwarded_for</var></tag-name> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1239 <tag-desc>the <header>X-Forwarded-For</header> client request header field |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1240 with the <var>$remote_addr</var> variable appended to it, separated by a comma. |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1241 If the <header>X-Forwarded-For</header> field is not present in the client |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1242 request header, the <var>$proxy_add_x_forwarded_for</var> variable is equal |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1243 to the <var>$remote_addr</var> variable.</tag-desc> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1244 </list> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1245 </para> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1246 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1247 </section> |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1248 |
7142ddd2764c
Translated current version of ngx_http_proxy_module documentation into English.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1249 </module> |