Admin: Text replacement - "Category:Wiki" to "Category:Wiki '''''[https://it-arts.net/index.php/Category:Wiki Return to Wiki Index]''''' "

2026-01-17T06:26:08Z

Text replacement - "Category:Wiki" to "Category:Wiki '''''[https://it-arts.net/index.php/Category:Wiki Return to Wiki Index]''''' "

← Older revision		Revision as of 06:26, 17 January 2026
Line 1:		Line 1:
	[[Category:Wiki]]		[[Category:Wiki]]

			'''''[https://it-arts.net/index.php/Category:Wiki Return to Wiki Index]'''''

Admin: Text replacement - "Category:Post-It" to "Category:Wiki"

2025-12-08T16:45:53Z

Text replacement - "Category:Post-It" to "Category:Wiki"

← Older revision		Revision as of 16:45, 8 December 2025
Line 1:		Line 1:
	[[Category:~~Post-It~~]]		[[Category:Wiki]]

imported>Z: /* proxy_cache_valid */

2020-04-24T12:59:30Z

proxy_cache_valid

New page

[[Category:Post-It]]

= Example =

<nowiki>
http {
proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=STATIC:10m
inactive=24h max_size=1g;
server {
location / {
proxy_pass http://1.2.3.4;
proxy_set_header Host $host;
proxy_buffering on;
proxy_cache STATIC;
proxy_cache_valid 200 1d;
proxy_cache_use_stale error timeout invalid_header updating
http_500 http_502 http_503 http_504;
}
}
}</nowiki>

== proxy_cache_path ==

Syntax:
<nowiki>
proxy_cache_path path [levels=levels] [use_temp_path=on|off] keys_zone=name:size [inactive=time] [max_size=size] [manager_files=number] [manager_sleep=time] [manager_threshold=time] [loader_files=number] [loader_sleep=time] [loader_threshold=time] [purger=on|off] [purger_files=number] [purger_sleep=time] [purger_threshold=time];
</nowiki>

Sets the path and other parameters of a cache. Cache data are stored in files. The file name in a cache is a result of applying the MD5 function to the cache key. The levels parameter defines hierarchy levels of a cache: from 1 to 3, each level accepts values 1 or 2. For example, in the following configuration .

== proxy_pass ==

Syntax:
<nowiki>
proxy_pass URL;</nowiki>

Sets the protocol and address of a proxied server and an optional URI to which a location should be mapped. As a protocol, “http” or “https” can be specified. The address can be specified as a domain name or IP address, and an optional port:

<nowiki>
proxy_pass http://localhost:8000/uri/;</nowiki>

or as a UNIX-domain socket path specified after the word “unix” and enclosed in colons:
<nowiki>
proxy_pass http://unix:/tmp/backend.socket:/uri/;</nowiki>

== proxy_set_header ==

Syntax:
<nowiki>
proxy_set_header field value;

Default:
proxy_set_header Host $proxy_host;
proxy_set_header Connection close;</nowiki>

Allows redefining or appending fields to the request header passed to the proxied server. The value can contain text, variables, and their combinations. These directives are inherited from the previous level if and only if there are no proxy_set_header directives defined on the current level. By default, only two fields are redefined:
<nowiki>
proxy_set_header Host $proxy_host;
proxy_set_header Connection close;</nowiki>

If caching is enabled, the header fields “If-Modified-Since”, “If-Unmodified-Since”, “If-None-Match”, “If-Match”, “Range”, and “If-Range” from the original request are not passed to the proxied server.

An unchanged “Host” request header field can be passed like this:
<nowiki>
proxy_set_header Host $http_host;</nowiki>

However, if this field is not present in a client request header then nothing will be passed. In such a case it is better to use the $host variable - its value equals the server name in the “Host” request header field or the primary server name if this field is not present:
<nowiki>
proxy_set_header Host $host;</nowiki>

In addition, the server name can be passed together with the port of the proxied server:
<nowiki>
proxy_set_header Host $host:$proxy_port;</nowiki>

If the value of a header field is an empty string then this field will not be passed to a proxied server:
<nowiki>
proxy_set_header Accept-Encoding "";</nowiki>

== proxy_buffering ==

Syntax:
<nowiki>
proxy_buffering on | off;

Default:
proxy_buffering on;
</nowiki>

== proxy_cache ==

Syntax:
<nowiki>
proxy_cache_use_stale error | timeout | invalid_header | updating | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | http_429 | off ...;

Default:
proxy_cache_use_stale off;
</nowiki>
Determines in which cases a stale cached response can be used during communication with the proxied server.

== proxy_cache_valid ==

Syntax:
<nowiki>
proxy_cache_valid [code ...] time;
</nowiki>
Sets caching time for different response codes. For example, the following directives
<nowiki>
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;</nowiki>

set 10 minutes of caching for responses with codes 200 and 302 and 1 minute for responses with code 404.

If only caching time is specified
<nowiki>
proxy_cache_valid 5m;</nowiki>

then only 200, 301, and 302 responses are cached.

In addition, the any parameter can be specified to cache any responses:
<nowiki>
proxy_cache_valid 200 302 10m;
proxy_cache_valid 301 1h;
proxy_cache_valid any 1m;</nowiki>

== proxy_cache_use_stale ==

Syntax:
<nowiki>
proxy_cache_use_stale error | timeout | invalid_header | updating | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | http_429 | off ...;

Default:
proxy_cache_use_stale off;
</nowiki>
Determines in which cases a stale cached response can be used during communication with the proxied server.

= Sources =

* https://www.nginx.com/resources/wiki/start/topics/examples/reverseproxycachingexample/
* https://nginx.org/en/docs/http/ngx_http_proxy_module.html

----

NGINX - Reverse Proxy With Caching - Revision history

Admin: Text replacement - "Category:Wiki" to "Category:Wiki '''''[https://it-arts.net/index.php/Category:Wiki Return to Wiki Index]''''' "

Admin: Text replacement - "Category:Post-It" to "Category:Wiki"

imported>Z: /* proxy_cache_valid */