Mastering Nginx

Directive Reference

[ 248 ]

Directive Explanation Context/Default

proxy_set_body The body of a request sent to an

upstream server may be altered by

setting this directive.

Valid contexts: http,

server, location

Default value: -

proxy_set_header Rewrites the contents of the

headers sent to an upstream

server; may also be used to not

send certain headers by setting its

value to the empty string.

Valid contexts: http,

server, location

Default value: Host

$proxy_host,

Connection close

proxy_ssl_session_

reuse

Sets whether or not SSL sessions

may be reused when proxying.

Valid contexts: http,

server, location

Default value: on

proxy_store Enables storing responses

retrieved from an upstream server

as files on disk. The on parameter

will use the alias or root

directive as the base path under

which to store the file. A string

may instead be given, to indicate

an alternative location to store the

files.

Valid contexts: http,

server, location

Default value: off

proxy_store_access Sets file access permissions for the

newly-created proxy_store files.

Valid contexts: http,

server, location

Default value:

user:rw

proxy_temp_file_

write_size

Limits the amount of data buffered

to a temporary file at one time, so

that NGINX will not be blocked

for too long on a single request.

Valid contexts: http,

server, location

Default value: 8k|16k

(platform dependent)

proxy_temp_path A directory where temporary

files may be buffered as they

are proxied from the upstream

server, optionally multilevel

deep. If a second, third, or fourth

parameter is given, these specify

a subdirectory hierarchy with the

parameter value as the number

of characters in the subdirectory

name.

Valid contexts: http,

server, location

Default value: proxy_

temp