本节内容：
nginx 负载均衡模块 ngx_http_upstream_module
ngx_http_upstream_module 模块用于定义可以被 proxy_pass、fastcgi_pass 以及memcached_pass 等指令引用的服务器群。
配置示例：
upstream backend {
server backend1.example.com weight=5;
server backend2.example.com:8080;
server unix:/tmp/backend3;
server backup1.example.com:8080 backup;
server backup2.example.com:8080 backup;
}
server {
location / {
proxy_pass http://backend;
}
}
动态可配置群，仅作为我们商业订阅的一部分：
upstream appservers {
zone appservers 64k;
server appserv1.example.com weight=5;
server appserv2.example.com:8080 fail_timeout=5s slow_start=30s;
server 192.0.2.1 max_fails=3;
server reserve1.example.com:8080 backup;
server reserve2.example.com:8080 backup;
}
server {
location / {
proxy_pass http://appservers;
health_check;
}
location /upstream_conf {
upstream_conf;
allow 127.0.0.1;
deny all;
}
}
指令
语法：upstream name { ... }
默认值：—
上下文：http
定义一群服务器。服务器可以监听到不同的端口。此外，监听 TCP 和 UNIX-domian socket 的服务器可以混合定义。
例如：
默认情况下，请求是使用一个加权重的循环负载方法分配给各个主机的。在上面的例子中，每七个请求会以以下方案进行分配：五个请求分给 backend1.example.com 而另外两个请求分别分配给第二和第三个主机。如果在连接一台主机时发生错误，当前请求会被传给下一台主机，如此这般知道所有运行中的服务器都被尝试。如果没有任何主机成功返回，客户端会受到从最后一台主机返回的通信结果。
语法：server address [parameters];
默认值：—
上下文：upstream
定义一台主机的地址以及其他一些参数。地址可以被指定为一个域名或一个 IP 地址，端口号参数可选，或者被指定为 "unix:" 前缀之后的一个 UNIX-domain socket 路径。端口号没指定的话就使用端口号 80。解析到多个 IP 地址的域名会一次性定义多台主机。
可以定义以下参数：
weight=number
设置服务器的权重，默认为 1。
max_fails=number
设置由 fail_timeout 定义的时间段内连接该主机的失败次数，以此来断定 fail_timeout 定义的时间段内该主机是否可用。默认情况下这个数值设置为 1。零值的话禁用这个数量的尝试。由proxy_next_upstream、fastcgi_next_upstream、以及memcached_next_upstream 等指令来判定错误尝试。
fail_timeout=time
设置
在指定时间内连接到主机的失败次数，超过该次数该主机被认为不可用。
服务器被视为无效的时段。
这个参数默认是 10 秒钟。
slow_start=time
设置一台不健康的主机变成健康主机，或者当一台主机在被认为不可用变成可用时，将其权重由零恢复到标称值的时间。默认值为零，也就是说，禁用慢启动。
这个功能仅作为我们的商业订阅的一部分。
backup
将当前服务器标记为备份服务器。当主服务器不可用时，向备用服务器传递请求。
down
标记当前服务器为永不可用；和 ip_hash 指令一起使用。
举例：
upstream backend {
server backend1.example.com weight=5;
server 127.0.0.1:8080 max_fails=3 fail_timeout=30s;
server unix:/tmp/backend3;
server backup1.example.com:8080 backup;
}
如果群里面只有一台主机，那么 max_fails、 fail_timeout 和 slow_start 参数将被忽略，而且这样的主机也永远不会被认为不可用。
语法：zone name size;
默认值：—
上下文：upstream
使群动态可配。定义持有群的配置和工作进程之间共享的运行时状态的共享内存区域的名字和大小。这样的群允许在运行时添加、删除和修改服务器。这个配置通过 upstream_conf 进行访问。
这一指令仅作为我们商业订购的一部分。
语法：ip_hash;
默认值：—
上下文：upstream
指定一个使用负载均衡方法根据客户端 IP 地址将请求分发给一些服务器的群。客户 IPv4 地址或者 IPv6 地址的前三个位群作为一个散列键。这个方法可以使同一个客户端的常常被发送给同一台主机，除非这台主机是不可用状态。在这种情况下(该主机不可用)客户端请求会被传递到另一台主机。大多数情况下，它将被发送给同一台主机。
Nginx 1.3.2 和 1.2.2 之后开始支持 IPv6 地址。
如果服务器中的一台需要临时移除掉，那么它应该使用 down 参数标记以保持客户 IP 地址的当前散列。
例如：
upstream backend {
ip_hash;
server backend1.example.com;
server backend2.example.com;
server backend3.example.com down;
server backend4.example.com;
}
在 Nginx 1.3.1 和 1.2.2 版本之前的版本是无法使用 ip_hash 负载均衡方式定义服务器权重的。
语法：keepalive connections;
默认：—
上下文：upstream
这一指令在 Nginx 版本 1.1.4 之后出现。
激活 upstream 服务器的连接缓存。
connections 参数设置保存在每个工作进程缓存中的 upstream 主机的闲置 keepalive 连接的最大个数。超出这个数目时，最近很少使用的连接被关闭。
应该特别指出的是 keepalive 指令并没有限制一个 Nginx 工作进程所能承载的连接总量。connections 应该设置为一个足够小的值以使 upstream 服务器也足以应对新的连接。
带有 keepalive 连接的 memcached upstream 配置例子：
upstream memcached_backend {
server 127.0.0.1:11211;
server 10.0.0.2:11211;
keepalive 32;
}
server {
...
location /memcached/ {
set $memcached_key $uri;
memcached_pass memcached_backend;
}
}
对于 HTTP，proxy_http_version 指令应该设置为 "1.1"，并且清空 "Connection" 头字段：
upstream http_backend {
server 127.0.0.1:8080;
keepalive 16;
}
server {
...
location /http/ {
proxy_pass http://http_backend;
proxy_http_version 1.1;
proxy_set_header Connection "";
...
}
}
作为一种选择，HTTP/1.0 持久连接可以通过传递 "Connection: Keep-Alive" 头字段到 upstream 服务器来使用，虽然这种方法并不被推荐。
对于 FastCGI 服务器，需要为持久连接设置 fastcgi_keep_conn：
upstream fastcgi_backend {
server 127.0.0.1:9000;
keepalive 8;
}
server {
location /fastcgi/ {
fastcgi_pass fastcgi_backend;
fastcgi_keep_conn on;
...
}
}
当使用 round-robin 之外的负载均衡方法时，需要在 keepalive 指令之前将他们激活。
SCGI 和 uwsgi 协议没有长连接的概念。
语法：least_conn;
默认值：—
上下文：upstream
描述：这一指令出现在版本 1.3.1 和 1.2.2 中。
定义一群应该在请求传递给具有最小有效连接的服务器时使用的负载均衡方法，要考虑到服务器的权重。如果有很多这样的服务器，将会使用带权重的 round-robin 方法。
语法：health_check [interval=time] [fails=number] [passes=number] [uri=uri] [match=name];
默认值：—
上下文：location
激活定期健康检查。
支持以下可选参数：
1，interval：两次连续性健康检查的间隔时间，默认为 5 秒；
2，fails：设置连续性健康检查失败的次数，超过这个次数的话这台服务器就被认为是不健康的，默认为 1；
3，passes：设置连续性健康检查通过的次数，超过这个次数的话这台服务器就被认为是健康的，默认为 1；
4，uri：定义健康检查请求用的 URI，默认为 "/"；
5，match：定义健康检查返回通过的匹配块的配置；默认情况下，返回应该具有状态码 2XX 或者 3XX。
例如，
将会每隔五秒钟发送 "/" 到 backend 群的每个服务器。如果有任何通信错误或者超时发生，或者代理服务器返回为 2XX 或者 3XX 之外的状态码，健康检查失败，这台服务器就被认为是不健康的了。来自客户端的请求不会被传递给不健康的服务器。
健康检查可以被配置成测试返回的状态码，头字段以及其值，还有正文内容。测试单独地使用 match 参数引用到的 match 指令进行配置，例如：
http {
server {
...
location / {
proxy_pass http://backend;
health_check match=welcome;
}
}
match welcome {
status 200;
header Content-Type = text/html;
body ~ "Welcome to nginx!";
}
}
这一配置说明了健康检查通过的条件是，健康检查请求应该成功返回，拥有状态码 200，Content-Type 是为 "text/html"，并且在正文中包含 "Welcome to nginx!"。
服务器群必须属于共享内存。
如果一些健康检查是为同一群服务器而定义，一个失败的任何检查就会使相关服务器被认为是不健康的。
这个指令仅作为我们的商业订阅的一部分。
语法：match name { ... }
默认值：—
上下文：http
定义已命名测试设置，用于核对健康检查请求的返回。
可以在一个返回中进行以下项目测试：
如果以上有些被定义，那么返回必须全都匹配时才能说明它测试通过。
仅仅检查返回正文的头 256 k 个字节。
例如：
这个指令仅作为我们的商业订阅的一部分。
语法：sticky cookie name [expires=time] [domain=domain] [path=path];
sticky route variable ...;
默认值：—
上下文：upstream
这一指令开始出现于版本 1.5.7。
激活会话关联，可以使来自同一客户端的请求总是传递给一群服务器中的同一个。例如：
upstream backend {
server backend1.example.com;
server backend2.example.com;
sticky_cookie_insert srv_id expires=1h domain=example.com path=/;
}
没有绑定到特定服务器的客户端请求会被传递到由配置的负载均衡方法选中的服务器。这个客户端的而后的请求将被传递到同一台服务器。如果指定服务器无法处理请求，一台新的服务器会被选中绑定，就像这个客户端的这次请求前没有绑定到任何服务器一样。
关于绑定服务器的信息保存在 HTTP cookie 中。第一个参数设置 cookie 名。其他参数如下：
expires
设置浏览器保持 cookie 的时间。特别值 max 将会使 cookie 在 "31 Dec 2037 23:55:55 GMT" 才过期。这个是老的浏览器所能知道最大日期值了。如果这个参数没有定义，cookie 会在浏览器会话结束时过期。
domain
定义设置的 cookie 的域名。
path
定义设置的 cookie 的路径。
如果任何一个参数被遗漏掉，相应的 cookie 属性就不会被设置上。
这个指令仅作为我们的商业订阅的一部分。
语法：upstream_conf;
默认值：—
上下文：location
开启 location 域的 HTTP upstream 配置接口。对于这一 location 的访问应该是受限的。
配置命令可以用于：
1，查看一群中的主要和备用服务器；
2，查看一个特别的服务器；
3，修改一个特别的服务器；
4，添加一个新的服务器(参考下边注释)；
5，移除一个特别的服务器。
正如在 server 指令中提到的那样，指定一个服务器作为一个域名可能导致多个服务器被添加到群。因为地址在一群不需要是独特的，单个服务器在一个群可以被唯一引用的话只有用他们的 ID。服务器的 ID 会被自动分配，并在群配置中显示。
一个配置命令包括作为请求参数传递的参数，例如：
http://127.0.0.1/upstream_conf?upstream=appservers
支持以下参数：
嵌入式变量
ngx_http_upstream_module 模块支持以下嵌入式变量：