Nginx系列之反向代理相关模块

##一、ngx_http_proxy_module模块 主要提供反向代理及缓存功能；

###1、proxy_pass指令

该指令用来设置被代理服务器的地址，可以是主机名称，IP地址加端口号等形式。 配置格式：

Syntax: proxy_pass URL;
Default: —
Context: location, if in location, limit_except

注意：proxy_pass后面的路径不带uri时，其会将location的uri传递给后端主机；

示例：

location /bbs/ {
  proxy_pass http://192.168.1.141;
}

# 访问http://www.codegreen.cn/bbs/此时后端节点收到的请求就是http://192.168.1.141/bbs/

注意：proxy_pass后面是一个uri时，其会将location中的uri替换为后端主机的uri；

示例：

location /bbs/ {
  proxy_pass http://192.168.1.141/www/;
}

注意：如果location定义其uri时使用了正则表达式匹配机制，则proxy_pass后的路径必须不能使用uri；

示例：

location ~* \.php$ {
  proxy_pass http://192.168.1.141;
}

注意：http://192.168.1.141后面一定不能加斜线"/" ###2、proxy_set_header指令

设定向后端主机发送请求报文的首部及其值； 配置格式：

Syntax: proxy_set_header field value;
Default: proxy_set_header Host $proxy_host;
         proxy_set_header Connection close;
Context: http, server, location

示例：

# 设置向后端服务器发送的客户端IP地址，用于让后端服务器获取用户真实的IP地址
proxy_set_header X-Real-IP $remote_add;
proxy_set_header X-Forward-For $remote_add;
# 设置向后端服务器发送请求报文中的主机名
proxy_set_header Host $host;

###3、proxy_cache_path指令

定义缓存，只能用于http上下文；

注意：当后端存在多个虚拟主机时，必须为每个虚拟主机单独使用一个缓存。

配置格式：

proxy_cache_path path [levels=levels] keys_zone=name:size [inactive=time] [max_size=size]

• path：定义缓存数据存放的根目录，改路径应该是预先存在于磁盘上的。
• evels：设置缓存目录的层级结构。
• keys_zone=name:size：name设定缓存区域的名称自定义，size表示使用多大的内存空间缓存；
• inactive=time：设置缓存超时时长；
• max_size=size：设置数据在磁盘中可使用的最大空间，超过此空间将使用LRU最近最少使用算法删除缓存；

示例：

proxy_cache_path  /var/cache/nginx/proxy levels=2:1 keys_zone=pcache:10m max_size=1g;

###4、proxy_cache指令

调用缓存，默认为off；

注意：当后端存在多个虚拟主机时必须为每个虚拟主机单独使用一个缓存。

配置格式：

Syntax: proxy_cache zone | off;
Default: proxy_cache off;
Context: http, server, location

示例：

proxy_cache pcache;

###5、proxy_cache_key指令

定义缓存键； 配置格式：

Syntax: proxy_cache_key string;
Default: proxy_cache_key $scheme$proxy_host$request_uri;
Context: http, server, location

###6、proxy_cache_valid指令

为不同的响应码设置不同的缓存时长； 配置格式：

Syntax: proxy_cache_valid [code ...] time;
Default: —
Context: http, server, location

示例：

proxy_cache_valid 200 301 302 10m;
proxy_cache_valid 404 1m;

###7、proxy_read_timeout指令

等待后端服务器发送响应报文的超时时长，默认为60秒。当后端服务器特别繁忙，请求处理不过来超出此处设置的时长时nginx反向代理就会返回给用户502的错误； 配置格式：

Syntax: proxy_read_timeout time;
Default: proxy_read_timeout 60s;
Context: http, server, location

###8、proxy_connect_timeout指令

与后端服务器建立连接的超时时长；默认为60秒；最长为70秒；

配置格式：

Syntax: proxy_connect_timeout time;
Default: proxy_connect_timeout 60s;
Context: http, server, location

###9、proxy_send_timeout指令

向后端服务器发送请求报文的超时时长；默认60秒。

配置格式：

Syntax: proxy_send_timeout time;
Default: proxy_send_timeout 60s;
Context: http, server, location

##二、ngx_http_headers_module模块 用于在响应给客户端报文中添加首部；

###1、add_header指令

向响应报文添加自定义首部，并赋值。

配置格式：

Syntax: add_header name value [always];
Default: —
Context: http, server, location, if in location

示例：

# 向响应客户端报文首部添加服务器地址；
add_header X-Via $server_addr;
# 如果代理服务器配置的缓存，向客户端展示缓存命中与否
add_header X-Cache $upstream_cache_status;

###2、expires指令

用于添加Expires及Cache-Control首部或修改首部的值； 配置格式：

Syntax: expires [modified] time;
        expires epoch | max | off;
Default: expires off;
Context: http, server, location, if in location

##三、ngx_http_upstream_module模块 将多个后端主机定义为服务器组，而后可由proxy_pass，fastcgi_pass,memcached_pass等调用；

###1、upstream指令

定义后端服务器组，引入新的上下文，只能用在http上下文； 配置格式：

Syntax: upstream name { ... }
Default: —
Context: http
name：名称，直接字符串；

###2、server指令

定义服务器的地址和相关的参数；只能用于upstream上下文；

配置格式：

Syntax: server address [parameters];
Default: —
Context: upstream

地址的格式：

IP[:port]
HOSTNAME[:port]
unix://PATH/TO/SOME_SOCK_FILE

参数：

• weight=number：服务器主机权重；
• max_fails=number：最大失败尝试次数；
• fail_timeout=time：设置服务器被识别为不可用的超时时长；
• backup：标记为备用主机，只有当所有server不可用时才使用；
• down：手动标记其不在处理任何用户请求，可实现代码灰度发布。

###3、ip_hash指令

设置源地址哈希调度算法；

Syntax: ip_hash;
Default: —
Context: upstream
```
###4、least-conn指令

最少连接调度算法；
配置格式：
```
Syntax: least_conn;
Default: —
Context: upstream
This directive appeared in versions 1.3.1 and 1.2.2.
```
###5、keepalive指令

指明多少个连接使用keepalive；通常后端有多少台主机就给多少；

配置格式：
```
Syntax: keepalive connections;
Default: —
Context: upstream
This directive appeared in version 1.1.4.
```
示例：
```
keepalive 4;
```

转载于:https://my.oschina.net/jiangshanlinux/blog/1514394