Nginx之upstream被动式重试机制的实现

 更新时间:2025年03月02日 11:13:47   作者:池562  
本文主要介绍了Nginx之upstream被动式重试机制的实现,可以通过proxy_next_upstream来自定义配置,具有一定的参考价值,感兴趣的可以了解一下

我们使用Nginx通过反向代理做负载均衡时,如果被代理的其中一个服务发生错误或者超时的时候,通常希望Nginx自动重试其他的服务,从而实现服务的高可用性。实际上Nginx本身默认会有错误重试机制,并且可以通过proxy_next_upstream来自定义配置。

Nginx 通过 proxy_next_upstream 参数来定义什么情况下会被认为是 fails,从而触发失败重试机制。

fails 可以分成两类:

  • 默认错误,包括 error、timeout
  • 选择定义错误,包含 invalid_header 以及各种异常 http 状态码错误等

默认错误

出现 error 的场景,常见的是上游服务器的服务重启、停止,或者异常崩溃导致的无法提供正常服务。而 timeout 的情况,就是代理请求过程中达到对应的超时配置,主要包括了:

  • proxy_connect_timeout,建立三次握手的时间
  • proxy_read_timeout,建立连接后,等待上游服务器响应以及处理请求的时间
  • proxy_send_timeout,数据回传的间隔时间(注意不是数据发送耗时)

选择定义错误

异常状态码部分(就是 4xx、5xx 错误)。上游服务器返回空响应或者非法响应头

invalid_header: a server returned an empty or invalid response;

其默认值是proxy_next_upstream error timeout,即发生网络错误以及超时,才会重试其他服务器。默认情况下服务返回500状态码是不会重试的

指令配置

proxy_next_upstream

设置当连接upstream服务器集群中的某个服务器第一次失败时,指定在哪些情况下将请求传递到下一个服务器

语法:	proxy_next_upstream error | timeout | invalid_header | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | http_429 | non_idempotent | off ...;
默认:	proxy_next_upstream error timeout;
使用位置:	http, ,serverlocation
  • error # 与服务器建立连接,向其传递请求或读取响应头时发生错误;
  • timeout # 在与服务器建立连接,向其传递请求或读取响应头时发生超时;
  • invalid_header # 服务器返回空的或无效的响应;
  • http_500 # 服务器返回代码为500的响应;
  • http_502 # 服务器返回代码为502的响应;
  • http_503 # 服务器返回代码为503的响应;
  • http_504 # 服务器返回代码504的响应;
  • http_403 # 服务器返回代码为403的响应;
  • http_404 # 服务器返回代码为404的响应;
  • http_429 # 服务器返回代码为429的响应(1.11.13);
  • non_idempotent # 通常,请求与 非幂等 方法(POST,LOCK,PATCH)不传递到请求是否已被发送到上游服务器(1.9.13)的下一个服务器; 启用此选项显式允许重试此类请求;
  • off # 禁用将请求传递给下一个服务器。

当请求类型是POST时,Nginx默认不会失败重试如果想让POST请求也会失败重试,需要配置non_idempotent。

配置示例:

代码语言:javascript

upstream nginxretry {
    server 127.0.0.1:9030 weight=10;
	server 127.0.0.1:9031 weight=10;
}
server {
    listen 9039;
    location / {
        proxy_pass http://nginxretry;
        proxy_next_upstream error timeout http_500;
    }
}

proxy_next_upstream_timeout

设置重试的超时时间,超时后不再重试,给用户返回错误,默认为0,即不做限制

语法:

proxy_next_upstream_timeout time;

Default:

proxy_next_upstream_timeout 0;

Context:

http, server, location

proxy_next_upstream_tries

设置重试的最大次数,若超过重试次数,也不再重试,默认为0,即不做限制(proxy_next_upstream_timeout时间内允许proxy_next_upstream_tries次重试,包括第一次)

语法:

proxy_next_upstream_tries number;

Default:

proxy_next_upstream_tries 0;

Context:

http, server, location

配置示例:

server {
	proxy_next_upstream error timeout;
	proxy_next_upstream_timeout 15s;
	proxy_next_upstream_tries 5;
}

重试限制方式

默认配置是没有做重试机制进行限制的,也就是会尽可能去重试直至失败。

Nginx 提供了以下两个参数来控制重试次数以及重试超时时间:

  • proxy_next_upstream_tries:设置重试次数,默认 0 表示无限制,该参数包含所有请求 upstream server 的次数,包括第一次后之后所有重试之和;
  • proxy_next_upstream_timeout:设置重试最大超时时间,默认 0 表示不限制,该参数指的是第一次连接时间加上后续重试连接时间,不包含连接上节点之后的处理时间

对upstream中某单一服务器的限制

  • max_fails:最大失败次数(0为标记一直可用,不检查健康状态)
  • fail_timeout:失败时间(当fail_timeout时间内失败了max_fails次,标记服务不可用fail_timeout时间后会再次激活次服务)

配置示例1:

upstream httpget {
    server 192.168.111.101:8080 max_fails=5 fail_timeout=10s;
    server 192.168.111.102:8080;
}

配置示例2:

proxy_connect_timeout 3s;
proxy_next_upstream_timeout 6s;
proxy_next_upstream_tries 3;

upstream test {
    server 127.0.0.1:8001 fail_timeout=60s max_fails=2; # Server A
    server 127.0.0.1:8002 fail_timeout=60s max_fails=2; # Server B
    server 127.0.0.1:8003 fail_timeout=60s max_fails=2; # Server C
}

到此这篇关于Nginx之upstream被动式重试机制的实现的文章就介绍到这了,更多相关Nginx upstream被动式重试机制内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家! 

相关文章

  • Nginx中配置HTTP/2协议的详细指南

    Nginx中配置HTTP/2协议的详细指南

    HTTP/2 是 HTTP 协议的下一代版本,旨在提高性能、减少延迟并优化现代网络环境中的通信效率,本文将为大家介绍Nginx配置HTTP/2协议想详细步骤,需要的可以参考下
    2025-04-04
  • Nginx实现浏览器可实时查看访问日志的步骤详解

    Nginx实现浏览器可实时查看访问日志的步骤详解

    我们经常需要在页面上实时查看nginx的日志输出,并且能在页面上显示,那么下面小编就给大家说下怎么在浏览器上实时动态的查看nginx的访问日志,有需要的朋友们可以参考借鉴。
    2016-09-09
  • nginx rewrite 实现URL跳转的方法

    nginx rewrite 实现URL跳转的方法

    今天小编就为大家分享一篇nginx rewrite 实现URL跳转的方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-08-08
  • Nginx转发需求querystring转写示例解析

    Nginx转发需求querystring转写示例解析

    这篇文章主要为大家介绍了Nginx转发需求querystring转写示例解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-08-08
  • 简介Nginx服务器的Websockets配置方法

    简介Nginx服务器的Websockets配置方法

    这篇文章主要介绍了简介Nginx服务器的Websockets配置方法,是使用Nginx服务器的网管的必备知识XD~需要的朋友可以参考下
    2015-06-06
  • nginx中调度算法的五种实现

    nginx中调度算法的五种实现

    本文主要介绍了nginx中调度算法的五种实现,包括轮询、权重轮询、IP哈希、fair和URL哈希,具有一定的参考价值,感兴趣的可以了解一下
    2025-03-03
  • nginx限制IP恶意调用短信接口处理方法

    nginx限制IP恶意调用短信接口处理方法

    这篇文章主要介绍了nginx限制IP恶意调用短信接口处理方法,一种是nginx黑名单方式,另一种是限制IP请求数。需要的朋友可以参考下
    2018-06-06
  • Nginx启动失败:端口80被占用问题的解决方案

    Nginx启动失败:端口80被占用问题的解决方案

    在Linux服务器上部署 Nginx 时,可能会遇到 Nginx 启动失败的情况,尤其是错误提示bind()to 0.0.0.0:80 failed,这种问题通常是由于端口80被其他进程占用导致的,本文将详细分析这一问题的原因,并提供多种解决方案,帮助你快速恢复Nginx的正常运行
    2025-02-02
  • Nginx负载均衡以及动静分离的原理与配置

    Nginx负载均衡以及动静分离的原理与配置

    动静分离和负载均衡都是配置nginx实现对请求进行操作,所以下面这篇文章主要给大家介绍了关于Nginx负载均衡以及动静分离的相关资料,需要的朋友可以参考下
    2021-06-06
  • Nginx启动显示80端口占用问题的解决方案

    Nginx启动显示80端口占用问题的解决方案

    这篇文章主要介绍了Nginx启动显示80端口占用问题的解决方案,文中通过代码示例和图文讲解的非常详细,对大家解决问题有一定的帮助,需要的朋友可以参考下
    2024-04-04

最新评论