Nginx upstream指令配置说明

upstream

定义服务器组，服务器可以监听不通的端口，也可以同时监听TCP和UNIX-domain套接字。

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

server

语法：server address [parameters];

parameters列表

• weight=number

  服务器的权重值，默认是1；

• max_conns=number

  设置允许的最大活动连接数。默认是0，表示不限制。（设置keepalive时，如果有多个worker共享内存，则连接数可能会超过设置的值）

• max_fails=number

  设置在fail_timeout参数设置的时间段内允许的失败最大尝试次数，默认是1，设置0表示失败不会尝试。

• fail_timeout=time

  fail_timeout的值包含两层意思：1.在这个时间段内服务器通信失败次数决定服务状态是否为不可用；2.服务器被视为不可用状态的时间段。

  默认是10秒。

• backup

  标记服务器是备用服务器，只有在其他服务器都不可用的情况下，才会请求该服务器。（在哈希、IP哈希、随机三种负载均衡模式下不可用）

• down

  标记服务器永久不可用状态。

在商用版本还增加的参数

• resolve

  监控服务器IP地址和域名的对应关系，可以自动重载upstream的配置，不需要重启nginx，服务器组必须共享内存。

  需要在http或者upstream块中设置resolver指令后，resolve参数才能有效

• route=string

  设置服务器路由名称

• service=name

  起用DNS SRV记录并设置服务名称（1.9.13版本开始增加）。需要指定resolve参数和不带端口的主机名才能使用。

  如果服务器名称中不包含点（.），则构造符合RFC规范的名称，将TCP协议添加到服务前缀中，例如要查找_http._tcp.backend.example.com的SRV记录，则必须配置：

  server backend.example.com service=http resolve;
  

  如果服务名中包含一个或多个点（.），会通过将服务名作为前缀与服务器名拼接在一起构造名称，例如要查找_http._tcp.backend.example.com和server1.backend.example.com的SRV记录，则需要配置：

  server backend.example.com service=_http._tcp resolve;
  server example.com service=server1.backend resolve;
  

  最高优先级的SRV记录（具有相同最低优先值的记录）被解析为主服务器，其它的服务器被解析为备用服务器，如果服务器指定了backup参数，则将高优先级SRV记录解析为备用服务器，其它SRV记录将被忽略。

• slow_start=time

  当服务器从不可用状态恢复过来时，通过slow_start设置的值决定将服务器权重从0逐渐恢复到正常设置值的时间。（在哈希、IP哈希、随机三种负载均衡模式下不可用）

• drain

  将服务器设置为“draining"模式，这种模式下，只有绑定到服务器的请求才会被代理到该服务器上（1.13.6版本其实起用）。

如果服务组中只有一台服务器，server指令的max_fails，fail_timeout， slow_start 参数都是无效的，nginx不会认为服务器不可用。

ngx_http_upstream_module 的自带参数

• $upstream_addr

  保存upstream服务器的IP地址和端口或者UNIX域名套接字；

• $upstream_bytes_received

  从服务器接收到的字节数（从1.11.4版本开始起用）；

• $upstream_bytes_sent

  发送到服务器的字节数（从1.15.8版本开始起用）；

• $upstream_cache_status

  保存访问响应缓存的状态（从0.8.3版本开始起用），缓存状态可能是：“MISS”, “BYPASS”, “EXPIRED”, “STALE”, “UPDATING”, “REVALIDATED”, 或者“HIT”；

• $upstream_connect_time

  保存于服务器完成连接话费的时间（从1.9.1版本开始起用），这个时间会保存几秒钟内以毫秒计量。在SLL连接的情况下，包含握手话费的时间；

• $upstream_cookie_name

  由上游服务器在“ Set-Cookie”响应标头字段中发送的具有指定名称的cookie（从1.7.1版本开始起用），仅保存来自最后一个服务器响应的cookie；

• $upstream_header_time

  保存从服务器接收响应头的时间（从1.7.0版本开始起用），这个时间会保存几秒钟内以毫秒计量；

• $upstream_http_name

  保存服务器响应头字段。例如可以通过 http_”为前缀的变量的规则相同。仅保存来自最后一个服务器的响应头字段；

• $upstream_queue_time

  保存请求在upstream队列中花费的时间（从1.13.9版本开始起用），这个时间会保存几秒钟内以毫秒计量；

• $upstream_response_length

  保存从服务器获得的响应的字节长度（从0.7.27版本开始起用）；

• $upstream_response_time

  保存从服务器接收响应花费的时间，这个时间会保存几秒钟内以毫秒计量；

• $upstream_status

  保存从服务器获得响应的状态码，如果无法选择服务器，则设置为502（Bad Gateway）；

• $upstream_trailer_name

  保存从服务器获得的响应末尾的字段（从1.13.10版本开始起用）。

·upstream指令块中还有很多其它参数，如zone、keepalive等请参考官网。

其他文章列表

spring web service系列1
spring web service系列2
spring web service系列3
maven配置文件settings.xml详解
Nginx转发请求过程解析
Nginx中的负载均衡算法
Nginx中虚拟服务器server指令配置说明
Nginx中proxy_pass/proxy_redirect/proxy_set_header配置说明
Nginx中ngx_http_core_module相关指令配置说明
Java自带JVM监控工具jstat使用详细说明
Java自带JVM监控工具jps使用详细说明
Java自带故障分析工具jmap工具使用说明
Java自带故障分析工具jhat工具使用说明