Nginx代理功能(未完)

Nginx代理模块允许传递请求到其它的服务器。

指令
Syntax:    proxy_bind address | off;
Default:    —
Context:    http, server, location
This directive appeared in version 0.8.22.

强制将与代理本机连接绑到指定IP地址，通俗来讲就是配置了多个基于名称或者基于IP的主机情况下，如果希望代理连接由指定的主机处理，就可以使用该指令进行配置。
当值为off，系统自动分配本机IP地址。

Syntax:    proxy_buffer_size size;
Default:    proxy_buffer_size 4k|8k;
Context:    http, server, location
设置第一次从代理服务器收到的响应的buffer的大小。这部分通常包含小的响应头部。默认，buffer大小等于内存页大小。可以是4K或8K，依赖于系统平台。当然也可以更小。

Syntax:    proxy_buffering on | off;
Default:    proxy_buffering on;
Context:    http, server, location
开启或关闭代理服务器的响应buffer功能。当nginx收到代理服务器的响应时候，它通过proxy_buffer_size和proxy_buffer指令设置。如果正响应没有合适的内存，部分可以保存在temporary_file里面。写入内存则通过proxy_max_temp_file_size 和 proxy_temp_file_write_size指令来设置。
当buffering关闭的时候，请求传递到客户端是同步的，当nginx收到响应的时候，立即回复。收到响应数据的最大大小可以被proxy_buffer_size指令设置。
bufferring可以开启或禁止传递yes或no在”X-Accel-Buffering”响应头部中设置。这个能力可以使用proxy_ignore_headers指令禁止。

Syntax:    proxy_buffers number size;
Default:    proxy_buffers 8 4k|8k;
Context:    http, server, location
类似于gzip_buffers不在叙述。

Syntax:    proxy_busy_buffers_size size;
Default:    proxy_busy_buffers_size 8k|16k;
Context:    http, server, location
该指令限制同时处于busy状态的buffer大小，默认size为两倍的proxy_buffer_size和proxy_buffer指令的大小。

Syntax:    proxy_cache zone | off;
Default:    proxy_cache off;
Context:    http, server, location
定义一个用于缓存的的共享内存区间，同样的区间可以被用在几个位置。参数值可以包含变量。off参数禁止缓存。

Syntax:    proxy_cache_bypass string ...;
Default:    —
Context:    http, server, location
定义一个条件，什么响应不会从cache中获取。如果字符串参数至少一个值而且不为空，那么响应不会从cache中获取。
proxy_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
proxy_cache_bypass $http_pragma    $http_authorization;
可以同proxy_no_cache指令一起使用。

Syntax:    proxy_cache_convert_head on | off;
Default:    proxy_cache_convert_head on;
Context:    http, server, location
This directive appeared in version 1.9.7.
开启或禁止或禁止HRAD方法会话。当会话被禁止了，cache_key应该被配置为包含$request_method

Syntax:    proxy_cache_key string;
Default:    proxy_cache_key $scheme$proxy_host$request_uri;
Context:    http, server, location
定义缓存的key，例如。
proxy_cache_key "$host$request_uri $cookie_user";
默认这个指令的值紧跟着字符串
proxy_cache_key $scheme$proxy_host$uri$is_args$args;

Syntax:proxy_cache_lock on | off;
Default:proxy_cache_lock off;
Context:http, server, location
当开启之后，只有一个请求在一段时间内被允许填充新的cache元素，根据proxy_cache_key指令来标示是什么cache传递到代理服务器。其它相同cache的请求要么等待cache中的响应，要么锁住这个cahe释放，根据proxy_cache_lock_timeout指令来设置。

Syntax:    proxy_cache_lock_age time;
Default:    proxy_cache_lock_age 5s;
Context:    http, server, location
如果最近的请求传递到被代理的服务器来填充新的cache元素，还没有完成，一个或更多请求可以被传递到代理服务器。

Syntax:    proxy_cache_lock_timeout time;
Default:    proxy_cache_lock_timeout 5s;
Context:    http, server, location
设置proxy_cahce_lock的超时时长，当time过期的时候，这个请求会传递到被代理的服务器，不管怎么样，响应不会被cached。
Before 1.7.8, the response could be cached.

Syntax:    proxy_cache_methods GET | HEAD | POST ...;
Default:    proxy_cache_methods GET HEAD;
Context:    http, server, location
客户端的请求方法列出在这个指令中，然后想要被cached，”GET”和”HEAD”方法一直被加入这个list中，尽管官方要求精确的指定方法。

Syntax:    proxy_cache_min_uses number;
Default:    proxy_cache_min_uses 1;
Context:    http, server, location
在响应数据被cached之后，发送给客户端的次数。

Syntax:    proxy_cache_path path [levels=levels] [use_temp_path=on|off] keys_zone=name:size [inactive=time] [max_size=size] [loader_files=number] [loader_sleep=time] [loader_threshold=time] [purger=on|off] [purger_files=number] [purger_sleep=time] [purger_threshold=time];
Default:    —
Context:    http
设置cahe的路径和其它参数，cache数据存储在文件里面，这个文件名是在cache中为应用MD5函数的结果。levels参数定义cache的层级关系。例如，在下面的配置中
proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m;
文件名看起来就像这样
/data/nginx/cache/c/29/b7f54b2df7773722d382f4809d65029c

Syntax:    proxy_cache_purge string ...;
Default:    —
Context:    http, server, location
This directive appeared in version 1.5.7.
定义一个条件，什么请求会被看做清除cache的请求。类似于proxy_cache_bypass。
案例：
proxy_cache_path /data/nginx/cache keys_zone=cache_zone:10m;

map $request_method $purge_method {
    PURGE   1;
    default 0;
}

server {
    ...
    location / {
        proxy_pass http://backend;
        proxy_cache cache_zone;
        proxy_cache_key $uri;
        proxy_cache_purge $purge_method;
    }
}

Syntax:    proxy_cache_revalidate on | off;
Default:    proxy_cache_revalidate off;
Context:    http, server, location
开启cache重用功能，如果请求使用了”If-Modified-Since”和”If-None-Match”头部元素。

Syntax:    proxy_cache_valid [code ...] time;
Default:    —
Context:    http, server, location
为不同的响应码设置不同的cache时间
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404      1m;

指令实在是太多，请参考原文
http://nginx.org/en/docs/http/ngx_http_proxy_module.html

实例:
upstrean videobackend
{
    server 192.168.1.2:80;
    server 192.168.1.3:80;
    server 192.168.1.4:80;
}
upstream filebackend
{
    server 192.168.1.5:80;
    server 192.168.1.6:80;
    server 192.168.1.7:80;
}
server
{
    listen 80;
    server_name www.myweb.com
    index index.html index.htm;
    location /video/ {
        proxy_pass http://videobackend;
        proxy_set_header host $host    ;
        ……
    }
    location /file/ {
        proxy_pass http://filebackend;
        proxy_set_header    X-Real-IP $remote_addr;
        proxy_set_header    X-Forward-For    $proxy_add_x_forwarded_for;
        ……
    }
}