Nginx模块参考手册:HTTP代理模块(…

来源:互联网 发布:ota产品数据分析 编辑:程序博客网 时间:2024/04/30 07:13
这些模块默认会全部编译进Nginx,除非手工指定某个模块在configure时排除。

这个模块可以转发请求到其他的服务器。HTTP/1.0无法使用keepalive(后端服务器将为每个请求创建并且删除连接)。nginx为浏览器发送HTTP/1.1并为后端服务器发送HTTP/1.0,这样浏览器就可以为浏览器处理keepalive。
如下例:

location / {
  proxy_pass      http://localhost:8000;
  proxy_set_header X-Real-IP  $remote_addr;
}
注意当使用httpproxy模块(甚至FastCGI),所有的连接请求在发送到后端服务器之前nginx将缓存它们,因此,在测量从后端传送的数据时,它的进度显示可能不正确。

指令

proxy_bind

语法:proxy_bind address
默认值:none
使用字段:http, server, location
可用版本:≥ 0.8.22
示例:

proxy_bind  192.168.1.1;
在调用connect()前将上游socket绑定到一个本地地址,如果主机有多个网络接口或别名,但是你希望代理的连接通过指定的借口或地址,可以使用这个指令。

proxy_buffer_size

语法:proxy_buffer_size the_size 
默认值:proxy_buffer_size 4k/8k 
使用字段:http, server, location 
设置从被代理服务器读取的第一部分应答的缓冲区大小。
通常情况下这部分应答中包含一个小的应答头。
默认情况下这个值的大小为指令proxy_buffers中指定的一个缓冲区的大小,不过可以将其设置为更小。

proxy_buffering

语法:proxy_buffering on|off 
默认值:proxy_buffering on 
使用字段:http, server, location 
为后端的服务器启用应答缓冲。
如果启用缓冲,nginx假设被代理服务器能够非常快的传递应答,并将其放入缓冲区,可以使用proxy_buffer_size和proxy_buffers设置相关参数。
如果响应无法全部放入内存,则将其写入硬盘。
如果禁用缓冲,从后端传来的应答将立即被传送到客户端。
nginx忽略被代理服务器的应答数目和所有应答的大小,接受proxy_buffer_size所指定的值。
对于基于长轮询的Comet应用需要关闭这个指令,否则异步的应答将被缓冲并且Comet无法正常工作。

proxy_buffers

语法:proxy_buffers the_number is_size; 
默认值:proxy_buffers 8 4k/8k; 
使用字段:http, server, location 
设置用于读取应答(来自被代理服务器)的缓冲区数目和大小,默认情况也为分页大小,根据操作系统的不同可能是4k或者8k。

proxy_busy_buffers_size

语法:proxy_busy_buffers_size size; 
默认值:proxy_busy_buffers_size proxy_buffer_size *2; 
使用字段:http, server, location, if 
未知。

proxy_cache

语法:proxy_cache zone_name; 
默认值:None 
使用字段:http, server, location 
设置一个缓存区域的名称,一个相同的区域可以在不同的地方使用。
在0.7.48后,缓存遵循后端的”Expires”, “Cache-Control: no-cache”,“Cache-Control:max-age=XXX”头部字段,0.7.66版本以后,”Cache-Control:“private”和”no-store”头同样被遵循。nginx在缓存过程中不会处理”Vary”头,为了确保一些私有数据不被所有的用户看到,后端必须设置“no-cache”或者”max-age=0”头,或者proxy_cache_key包含用户指定的数据如$cookie_xxx,使用cookie的值作为proxy_cache_key的一部分可以防止缓存私有数据,所以可以在不同的location中分别指定proxy_cache_key的值以便分开私有数据和公有数据。
缓存指令依赖代理缓冲区(buffers),如果proxy_buffers设置为off,缓存不会生效。

proxy_cache_bypass

语法: proxy_cache_bypass line […];
默认值: off
使用字段: http, server, location
这个指令指定不使用缓存返回应答的条件,如果指定的变量中至少有一个为非空,或者不等于“0”,这个应答将不从缓存中返回:

 proxy_cache_bypass $ cookie_nocache $arg_nocache $ arg_comment;
 proxy_cache_bypass $ http_pragma $http_authorization;
可以结合proxy_no_cache使用。

proxy_cache_key

语法:proxy_cache_key line; 
默认值:$scheme$proxy_host$request_uri; 
使用字段:http, server, location 
指令指定了包含在缓存中的缓存关键字。

proxy_cache_key "$host$request_uri$cookie_user";
注意默认情况下服务器的主机名并没有包含到缓存关键字中,如果你为你的站点在不同的location中使用二级域,你可能需要在缓存关键字中包换主机名:

proxy_cache_key "$scheme$host$request_uri";
proxy_cache_methods

语法:proxy_cache_methods [GET HEADPOST]; 
默认值:proxy_cache_methods GET HEAD; 
使用字段:http, server, location 
GET/HEAD用来装饰语句,即你无法禁用GET/HEAD即使你只使用下列语句设置:

proxy_cache_methods POST;
proxy_cache_min_uses

语法:proxy_cache_min_uses the_number; 
默认值:proxy_cache_min_uses 1; 
使用字段:http, server, location 
多少次请求后应答将被缓存,默认1。

proxy_cache_path

语法:proxy_cache_path path [levels=number]keys_zone=zone_name:zone_size [inactive=time][max_size=size]; 
默认值:None 
使用字段:http 
指令指定缓存的路径和一些其他参数,缓存的数据存储在文件中,并且使用代理url的哈希值作为关键字与文件名。levels参数指定缓存的子目录数,例如:

proxy_cache_path  /data/nginx/cache levels=1:2  keys_zone=one:10m;
文件名类似于:

/data/nginx/cache/c/29/b7f54b2df7773722d382f4809d65029c 

可以使用任意的1位或2位数字作为目录结构,如 X, X:X,或X:X:X e.g.: “2”, “2:2”,“1:1:2”,但是最多只能是三级目录。
所有活动的key和元数据存储在共享的内存池中,这个区域用keys_zone参数指定。
注意每一个定义的内存池必须是不重复的路径,例如:

proxy_cache_path  /data/nginx/cache/one   levels=1     keys_zone=one:10m;
proxy_cache_path  /data/nginx/cache/two   levels=2:2   keys_zone=two:100m;
proxy_cache_path  /data/nginx/cache/three levels=1:1:2 keys_zone=three:1000m;
如果在inactive参数指定的时间内缓存的数据没有被请求则被删除,默认inactive为10分钟。
一个名为cachemanager的进程控制磁盘的缓存大小,它被用来删除不活动的缓存和控制缓存大小,这些都在max_size参数中定义,当目前缓存的值超出max_size指定的值之后,超过其大小后最少使用数据(LRU替换算法)将被删除。
内存池的大小按照缓存页面数的比例进行设置,一个页面(文件)的元数据大小按照操作系统来定,FreeBSD/i386下为64字节,FreeBSD/amd64下为128字节。
proxy_cache_path和proxy_temp_path应该使用在相同的文件系统上。

proxy_cache_use_stale

语法:proxy_cache_use_stale[error|timeout|updating|invalid_header|http_500|http_502|http_503|http_504|http_404|off][…]; 
默认值:proxy_cache_use_stale off; 
使用字段:http, server, location 
这个指令告诉nginx何时从代理缓存中提供一个过期的响应,参数类似于proxy_next_upstream指令。
为了防止缓存失效(在多个线程同时更新本地缓存时),你可以指定'updating'参数,它将保证只有一个线程去更新缓存,并且在这个线程更新缓存的过程中其他的线程只会响应当前缓存中的过期版本。

proxy_cache_valid

语法:proxy_cache_valid reply_code [reply_code …]time; 
默认值:None 
使用字段:http, server, location 
为不同的应答设置不同的缓存时间,例如:

  proxy_cache_valid  200 302 10m;
  proxy_cache_valid  404     1m;
为应答代码为200和302的设置缓存时间为10分钟,404代码缓存1分钟。
如果只定义时间:

 proxy_cache_valid 5m;
那么只对代码为200, 301和302的应答进行缓存。
同样可以使用any参数任何应答。

  proxy_cache_valid  200 30210m;
  proxy_cache_valid  3011h;
  proxy_cache_valid  any1m;
proxy_connect_timeout

语法:proxy_connect_timeouttimeout_in_seconds 
默认值:proxy_connect_timeout 60s 
使用字段:http, server, location 
指定一个连接到代理服务器的超时时间,单位为秒,需要注意的是这个时间最好不要超过75秒。
这个时间并不是指服务器传回页面的时间(这个时间由proxy_read_timeout声明)。如果你的前端代理服务器是正常运行的,但是遇到一些状况(例如没有足够的线程去处理请求,请求将被放在一个连接池中延迟处理),那么这个声明无助于服务器去建立连接。
可以通过指定时间单位以免引起混乱,支持的时间单位有”s”(秒), “ms”(毫秒), “y”(年), “M”(月),“w”(周), “d”(日), “h”(小时),和 “m”(分钟)。
这个值不能大于597小时。

proxy_headers_hash_bucket_size

语法:proxy_headers_hash_bucket_sizesize; 
默认值:proxy_headers_hash_bucket_size 64; 
使用字段:http, server, location, if 
设置头部哈希表大小。
这将限制头部字段名称的长度大小,如果你使用超过64个字符的头部名可以加大这个值。

proxy_headers_hash_max_size

语法:proxy_headers_hash_max_size size; 
默认值:proxy_headers_hash_max_size 512; 
使用字段:http, server, location, if 
设置头部哈希表的最大值,不能小于你后端服务器设置的头部总数。

proxy_hide_header

语法:proxy_hide_header the_header 
使用字段:http, server, location 
nginx不对从被代理服务器传来的”Date”, “Server”,“X-Pad”和”X-Accel-…“应答进行转发,这个参数允许隐藏一些其他的头部字段,但是如果上述提到的头部字段必须被转发,可以使用proxy_pass_header指令,例如:需要隐藏MS-OfficeWebserver和AspNet-Version可以使用如下配置:

location / {
  proxy_hide_header X-AspNet-Version;
  proxy_hide_headerMicrosoftOfficeWebServer;
}
当使用X-Accel-Redirect时这个指令非常有用。例如,你可能要在后端应用服务器对一个需要下载的文件设置一个返回头,其中X-Accel-Redirect字段即为这个文件,同时要有恰当的Content-Type,但是,重定向的URL将指向包含这个文件的文件服务器,而这个服务器传递了它自己的Content-Type,可能这并不是正确的,这样就忽略了后端应用服务器传递的Content-Type。为了避免这种情况你可以使用这个指令:

location / {
  proxy_pass http://backend_servers;
}
 
location /files/ {
  proxy_pass http://fileserver;
  proxy_hide_header Content-Type;
proxy_ignore_client_abort

语法:proxy_ignore_client_abort [ on|off] 
默认值:proxy_ignore_client_abort off 
使用字段:http, server, location 
防止在客户端自己终端请求的情况下中断代理请求。

proxy_ignore_headers

语法:proxy_ignore_headers name [name …] 
默认值:none 
使用字段:http, server, location 
这个指令(0.7.54+) 禁止处理来自代理服务器的应答。
可以指定的字段为”X-Accel-Redirect”, “X-Accel-Expires”,“Expires”或”Cache-Control”。

proxy_intercept_errors

语法:proxy_intercept_errors [ on|off ] 
默认值:proxy_intercept_errors off 
使用字段:http, server, location 
使nginx阻止HTTP应答代码为400或者更高的应答。
默认情况下被代理服务器的所有应答都将被传递。 
如果将其设置为on则nginx会将阻止的这部分代码在一个error_page指令处理,如果在这个error_page中没有匹配的处理方法,则被代理服务器传递的错误应答会按原样传递。

proxy_max_temp_file_size

语法:proxy_max_temp_file_size size; 
默认值:proxy_max_temp_file_size 1G; 
使用字段:http, server, location, if 
当代理缓冲区过大时使用一个临时文件的最大值,如果文件大于这个值,将同步传递请求而不写入磁盘进行缓存。
如果这个值设置为零,则禁止使用临时文件。

proxy_method

语法:proxy_method [method] 
默认值:None 
使用字段:http, server, location 
为后端服务器忽略HTTP请求处理方式,假如你将这个指令指定为POST,那么所有转发到后端的请求都将使用POST请求方式。
示例配置:

  proxy_method POST;
proxy_next_upstream

语法: proxy_next_upstream[error|timeout|invalid_header|http_500|http_502|http_503|http_504|http_404|off] 
默认值:proxy_next_upstream error timeout 
使用字段:http, server, location 
确定在何种情况下请求将转发到下一个服务器:

error - 在连接到一个服务器,发送一个请求,或者读取应答时发生错误。
timeout - 在连接到服务器,转发请求或者读取应答时发生超时。
invalid_header - 服务器返回空的或者错误的应答。
http_500 - 服务器返回500代码。
http_502 - 服务器返回502代码。
http_503 - 服务器返回503代码。
http_504 - 服务器返回504代码。
http_404 - 服务器返回404代码。
off - 禁止转发请求到下一台服务器。
转发请求只发生在没有数据传递到客户端的过程中。

proxy_no_cache

语法:proxy_no_cache variable1 variable2…; 
默认值:None 
使用字段:http, server, location 
确定在何种情况下缓存的应答将不会使用,示例:

proxy_no_cache $cookie_nocache $arg_nocache$arg_comment;
proxy_no_cache $http_pragma    $http_authorization;
如果为空字符串或者等于0,表达式的值等于false,例如,在上述例子中,如果在请求中设置了cookie“nocache”,请求将总是穿过缓存而被传送到后端。
注意:来自后端的应答依然有可能符合缓存条件,有一种方法可以快速的更新缓存中的内容,那就是发送一个拥有你自己定义的请求头部字段的请求。例如:My-Secret-Header,那么在proxy_no_cache指令中可以这样定义:

proxy_no_cache $http_my_secret_header;

proxy_pass

语法:proxy_pass URL 
默认值:no 
使用字段:location, location中的if字段 
这个指令设置被代理服务器的地址和被映射的URI,地址可以使用主机名或IP加端口号的形式,例如:

proxy_pass http://localhost:8000/uri/;
或者一个unix socket:

proxy_pass http://unix:/path/to/backend.socket:/uri/;
路径在unix关键字的后面指定,位于两个冒号之间。
注意:HTTPHost头没有转发,它将设置为基于proxy_pass声明,例如,如果你移动虚拟主机example.com到另外一台机器,然后重新配置正常(监听example.com到一个新的IP),同时在旧机器上手动将新的example.comIP写入/etc/hosts,同时使用proxy_pass重定向到http://example.com,然后修改DNS到新的IP。
当传递请求时,Nginx将location对应的URI部分替换成proxy_pass指令中所指定的部分,但是有两个例外会使其无法确定如何去替换:

location通过正则表达式指定;
在使用代理的location中利用rewrite指令改变URI,使用这个配置可以更加精确的处理请求(break):
location  /name/ {
  rewrite     /name/([^/] +) /users?name=$1  break;
  proxy_pass  http://127.0.0.1;
}
这些情况下URI并没有被映射传递。
此外,需要标明一些标记以便URI将以和客户端相同的发送形式转发,而不是处理过的形式,在其处理期间:

两个以上的斜杠将被替换为一个: ”//” – ”/”;
删除引用的当前目录:”/./” – ”/”;
删除引用的先前目录:”/dir /../” – ”/“。
如果在服务器上必须以未经任何处理的形式发送URI,那么在proxy_pass指令中必须使用未指定URI的部分:

location  /some/path/ {
  proxy_pass  http://127.0.0.1;
}
在指令中使用变量是一种比较特殊的情况:被请求的URL不会使用并且你必须完全手工标记URL。
这意味着下列的配置并不能让你方便的进入某个你想要的虚拟主机目录,代理总是将它转发到相同的URL(在一个server字段的配置):

location / {
  proxy_pass  http://127.0.0.1:8080/VirtualHostBase/https/$server_name:443/some/path/VirtualHostRoot;
}
解决方法是使用rewrite和proxy_pass的组合:

location / {
  rewrite ^(.*)$/VirtualHostBase/https/$server_name:443/some/path/VirtualHostRoot$1break;
  proxy_pass  http://127.0.0.1:8080;
}
这种情况下请求的URL将被重写, proxy_pass中的拖尾斜杠并没有实际意义。
如果需要通过ssl信任连接到一个上游服务器组,proxy_pass前缀为https://,并且同时指定ssl的端口,如:

upstream backend-secure {
  server 10.0.0.20:443;
}
 
server {
  listen 10.0.0.1:443;
  location / {
    proxy_passhttps://backend-secure;
  }
}
proxy_pass_header

语法:proxy_pass_header the_name 
使用字段:http, server, location 
这个指令允许为应答转发一些隐藏的头部字段。
如:

location / {
  proxy_pass_header X-Accel-Redirect;
}
proxy_pass_request_body

语法:proxy_pass_request_body [ on | off ]; 
默认值:proxy_pass_request_body on; 
使用字段:http, server, location 
可用版本:0.1.29
不管什么情况都将请求实体通过代理。
通常一直处于on状态。

proxy_pass_request_headers

语法:proxy_pass_request_headers [ on | off ]; 
默认值:proxy_pass_request_headers on; 
使用字段:http, server, location 
可用版本:0.1.29
不管什么情况都将请求头部通过代理。
通常一直处于on状态。

proxy_redirect

语法:proxy_redirect [ default|off|redirect replacement] 
默认值:proxy_redirect default 
使用字段:http, server, location 
如果需要修改从被代理服务器传来的应答头中的”Location”和”Refresh”字段,可以用这个指令设置。
假设被代理服务器返回Location字段为:http://localhost:8000/two/some/uri/
这个指令:

proxy_redirect http://localhost:8000/two/http://frontend/one/;
将Location字段重写为http://frontend/one/some/uri/。
在代替的字段中可以不写服务器名:

proxy_redirect http://localhost:8000/two/ /;
这样就使用服务器的基本名称和端口,即使它来自非80端口。
如果使用“default”参数,将根据location和proxy_pass参数的设置来决定。
例如下列两个配置等效:

location /one/ {
  proxy_pass     http://upstream:port/two/;
  proxy_redirect  default;
}
 
location /one/ {
  proxy_pass     http://upstream:port/two/;
  proxy_redirect  http://upstream:port/two/   /one/;
}
在指令中可以使用一些变量:

proxy_redirect   http://localhost:8000/  http://$host:$server_port/;
这个指令有时可以重复:

  proxy_redirect  default;
  proxy_redirect  http://localhost:8000/   /;
  proxy_redirect  http://www.example.com/   /;
参数off将在这个字段中禁止所有的proxy_redirect指令:

  proxy_redirect  off;
  proxy_redirect  default;
  proxy_redirect  http://localhost:8000/   /;
  proxy_redirect  http://www.example.com/   /;
利用这个指令可以为被代理服务器发出的相对重定向增加主机名:

proxy_redirect   /  /;
proxy_read_timeout

语法:proxy_read_timeout time 
默认值:proxy_read_timeout 60s 
使用字段:http, server, location 
决定读取后端服务器应答的超时时间,单位为秒,它决定nginx将等待多久时间来取得一个请求的应答。超时时间是指完成了两次握手后并且状态为established的超时时间。
相对于proxy_connect_timeout,这个时间可以扑捉到一台将你的连接放入连接池延迟处理并且没有数据传送的服务器,注意不要将此值设置太低,某些情况下代理服务器将花很长的时间来获得页面应答(例如如当接收一个需要很多计算的报表时),当然你可以在不同的location里面设置不同的值。
可以通过指定时间单位以免引起混乱,支持的时间单位有”s”(秒), “ms”(毫秒), “y”(年), “M”(月),“w”(周), “d”(日), “h”(小时),和 “m”(分钟)。
这个值不能大于597小时。

proxy_redirect

语法:proxy_redirect [ default|off|redirect replacement ];
默认值:proxy_redirect default;
使用字段:http, server, location
这个指令为被代理服务器应答中必须改变的应答头:”Location”和”Refresh”设置值。
我们假设被代理的服务器返回的应答头字段为:Location:http://localhost:8000/two/some/uri/。
指令:

proxy_redirect http://localhost:8000/two/http://frontend/one/;
会将其重写为:Location: http://frontend/one/some/uri/。
在重写字段里面可以不使用服务器名:

proxy_redirect http://localhost:8000/two/ /;
这样,默认的服务器名和端口将被设置,端口默认80。
默认的重写可以使用参数default,将使用location和proxy_pass的值。
下面两个配置是等价的:

location /one/ {
  proxy_pass     http://upstream:port/two/;
  proxy_redirect  default;
}
 
location /one/ {
  proxy_pass     http://upstream:port/two/;
  proxy_redirect  http://upstream:port/two/   /one/;
}
同样,在重写字段中可以使用变量:

proxy_redirect   http://localhost:8000/  http://$host:$server_port/;
这个指令可以重复使用:

proxy_redirect   default;
proxy_redirect   http://localhost:8000/   /;
proxy_redirect   http://www.example.com/  /;
参数off在本级中禁用所有的proxy_redirect指令:

proxy_redirect   off;
proxy_redirect   default;
proxy_redirect   http://localhost:8000/   /;
proxy_redirect   http://www.example.com/  /;
这个指令可以很容易的将被代理服务器的服务器名重写为代理服务器的服务器名:

proxy_redirect   /  /;
proxy_redirect_errors

不推荐使用,请使用 proxy_intercept_errors。
proxy_send_lowat

语法:proxy_send_lowat [ on | off ] 
默认值:proxy_send_lowat off; 
使用字段:http, server, location, if 
设置SO_SNDLOWAT,这个指令仅用于FreeBSD。

proxy_send_timeout

语法:proxy_send_timeout seconds 
默认值:proxy_send_timeout 60s 
使用字段:http, server, location 
设置代理服务器转发请求的超时时间,单位为秒,同样指完成两次握手后的时间,如果超过这个时间代理服务器没有数据转发到被代理服务器,nginx将关闭连接。
可以通过指定时间单位以免引起混乱,支持的时间单位有”s”(秒), “ms”(毫秒), “y”(年), “M”(月),“w”(周), “d”(日), “h”(小时),和 “m”(分钟)。
这个值不能大于597小时。

proxy_set_body

语法:proxy_set_body [ on | off ] 
默认值:proxy_set_body off; 
使用字段:http, server, location, if 
可用版本:0.3.10。
设置通过后端的body的值,这个值可以包含变量。

proxy_set_header

语法:proxy_set_header header value 
默认值: Host and Connection
使用字段:http, server, location 
这个指令允许将发送到被代理服务器的请求头重新定义或者增加一些字段。
这个值可以是一个文本,变量或者它们的组合。
proxy_set_header在指定的字段中没有定义时会从它的上级字段继承。
默认只有两个字段可以重新定义:

proxy_set_header Host $proxy_host;
proxy_set_header Connection Close;
未修改的请求头“Host”可以用如下方式传送:

proxy_set_header Host $http_host;
但是如果这个字段在客户端的请求头中不存在,那么不发送数据到被代理服务器。
这种情况下最好使用$Host变量,它的值等于请求头中的”Host”字段或服务器名:

proxy_set_header Host $host;
此外,可以将被代理的端口与服务器名称一起传递:

proxy_set_header Host $host:$proxy_port;
如果设置为空字符串,则不会传递头部到后端,例如下列设置将禁止后端使用gzip压缩:

proxy_set_header  Accept-Encoding "";
proxy_ssl_session_reuse

语法:proxy_ssl_session_reuse [ on | off ];
默认值: proxy_ssl_session_reuse on;
使用字段:http, server, location
使用版本:≥ 0.7.11
当使用https连接到上游服务器时尝试重用ssl会话。

proxy_store

语法:proxy_store [on | off | path] 
默认值:proxy_store off 
使用字段:http, server, location 
这个指令设置哪些传来的文件将被存储,参数”on”保持文件与alias或root指令指定的目录一致,参数”off”将关闭存储,路径名中可以使用变量:

proxy_store   /data/www$original_uri;
应答头中的”Last-Modified”字段设置了文件最后修改时间,为了文件的安全,可以使用proxy_temp_path指定一个临时文件目录。
这个指令为那些不是经常使用的文件做一份本地拷贝。从而减少被代理服务器负载。

location /images/ {
  root              /data/www;
  error_page         404 = /fetch$uri;
}
 
location /fetch {
  internal;
  proxy_pass         http://backend;
  proxy_store        on;
  proxy_store_access  user:rw  group:rw  all:r;
  proxy_temp_path     /data/temp;
  alias             /data/www;
}
或者通过这种方式:

location /images/ {
  root              /data/www;
  error_page         404 = @fetch;
}
 
location @fetch {
  internal;
 
  proxy_pass         http://backend;
  proxy_store        on;
  proxy_store_access  user:rw  group:rw  all:r;
  proxy_temp_path     /data/temp;
 
  root              /data/www;
}
注意proxy_store不是一个缓存,它更像是一个镜像。

proxy_store_access

语法:proxy_store_access users:permissions [users:permission…] 
默认值:proxy_store_access user:rw 
使用字段:http, server, location 
指定创建文件和目录的相关权限,如:

proxy_store_access  user:rw group:rw  all:r;
如果正确指定了组和所有的权限,则没有必要去指定用户的权限:

proxy_store_access  group:rw all:r;
proxy_temp_file_write_size

语法:proxy_temp_file_write_size size; 
默认值:proxy_temp_file_write_size [”#proxy buffer size”] *2; 
使用字段:http, server, location, if 
设置在写入proxy_temp_path时数据的大小,在预防一个工作进程在传递文件时阻塞太长。

proxy_temp_path

语法:proxy_temp_path dir-path [ level1 [ level2 [ level3 ]; 
默认值:在configure时由–http-proxy-temp-path指定 
使用字段:http, server, location 
类似于http核心模块中的client_body_temp_path指令,指定一个地址来缓冲比较大的被代理请求。

proxy_upstream_fail_timeout

0.5.0版本后不推荐使用,请使用http负载均衡模块中server指令的fail_timeout参数。

proxy_upstream_max_timeout

0.5.0版本后不推荐使用,请使用http负载均衡模块中server指令的max_fails参数。

变量

该模块中包含一些内置变量,可以用于proxy_set_header指令中以创建头部。

$proxy_add_x_forwarded_for

包含客户端的请求头“X-Forwarded-For”与$remote_addr,用逗号分开,如果不存在X-Forwarded-For请求头,则$proxy_add_x_forwarded_for等于$remote_addr。

$proxy_host

被代理服务器的主机名与端口号。

$proxy_internal_body_length

通过proxy_set_body设置的代理请求实体的长度。

$proxy_host

被代理服务器的端口号。
0 0