Nginx upstream模块配置-官方翻译版

ngx_http_upstream_module 模块用于定义可以被proxy_pass, fastcgi_pass, uwsgi_pass, scgi_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指令

upstream指令用于定义服务器集群。服务器可以监听在不同端口。另外，监听在TCP和UNIX-domain socket的服务器可以混合使用

upstream范例

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  backup;
}

默认，使用带权重的round-robin平衡算法将请求分派到服务器。在上面的例子中， 每7个请求将被如下分配：

5个请求去backend1.example.com
1个请求去127.0.0.1:8080
1个请求去unix:/tmp/backend3

在和某台服务器通讯的过程中，如果发生错误， 请求将被分派给下一个服务器， 以此类推直到所有可用服务器都被尝试。如果没有任何一个服务器可以可以返回成功的应答，则客户端将会收到和最后一台机器的通讯结果。

server指令

server指令用于定义一台服务器的地址和其他参数。地址可以是域名或者IP地址，端口可选，或者是以"unix:"前缀指定的UNIX-domain socket路径。
如果端口没有指定，将使用80端口。可以解析为多个IP地址的域名将一次性定义多台服务器。

下面是可用的参数列表:

weight=number
设置服务器的权重，默认为1.

max_fails=number
定义在参数fail_timeout定义的时间内，与服务器通讯的不成功的数量。
默认情况，不成功尝试次数被设置为1.如果设置为0则关闭尝试计数。

fail_timeout=time
在此时间段期间与服务器通讯的不成功尝试，以判断服务器是否不可到达和服务器被判定为不可到达的时间
注：如果设置为max_fails=5;fail_timeout=30s，表示如果有5次请求失败，则该服务器被断定为不可到达，之后30s之内将不再尝试这台机器。再之后的每30s，都将进行最多5次尝试，如果继续失败则继续判断为不可到达并不再尝试。

backup
标记当前服务器为备用服务器。当主服务器(注：应该是没有标记为backup和down的服务器)都不能达到时,请求将被分派到backup服务器上。

down
将当前服务器标记为永久不可到达。

ip-hash指令

指定集群使用的负载均衡算法，基于客户端IP地址将请求分派给服务器。这个算法保证从同一个客户端来的请求总是被分派到同样的服务器，除非这个服务器不可达到。后面这种情况下客户端请求将被分派到其他服务器。大多数情况，请求总是被分派到同一个服务器。

如果某台服务器需要被永久移除，那么应该将它标记为down以便保持当前的客户端IP地址的哈希。

例如：
upstream backend {
    ip_hash;

    server backend1.example.com;
    server backend2.example.com;
    server backend3.example.com down;
    server backend4.example.com;
}

least_conn指令

指定集群应该使用的负载均衡方法，分派请求到活动连接数量最少的服务器。如果有多台这样的服务器，这些服务器将尝试轮流使用带权重的round-robin平衡算法。

例如：
upstream backend {
    least_conn;

    server backend1.example.com;
    server backend2.example.com;
    server backend3.example.com down;
    server backend4.example.com;
}

参考：敖小剑的博客

• 本文作者： GaryWu
• 本文链接： https://garywu520.github.io/2018/04/03/Nginx-upstream模块配置-官方翻译版/
• 版权声明： 本博客所有文章除特别声明外，均采用 MIT 许可协议。转载请注明出处！