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_failsfail_timeoutslow_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

    保存服务器响应头字段。例如可以通过upstream_http_server使用响应头中的"Server"字段,将头字段名称转换为变量名称的规则与以“ 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指令块中还有很多其它参数,如zonekeepalive请参考官网

其他文章列表

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工具使用说明

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,761评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,953评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,998评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,248评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,130评论 4 356
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,145评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,550评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,236评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,510评论 1 291
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,601评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,376评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,247评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,613评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,911评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,191评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,532评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,739评论 2 335

推荐阅读更多精彩内容