Nginx超时重试、保护机制

1. 超时配置

http {
    upstream backend {
        server backend1.example.com;
        server backend2.example.com;
        server backend3.example.com;
    }
 
    server {
        location / {
            proxy_pass http://backend;
            proxy_connect_timeout 10s;
            proxy_send_timeout 10s;
            proxy_read_timeout 10s;
            proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
        }
    }
}

　　proxy_connect_timeout ：定义了Nginx尝试与上游服务器建立连接的超时时间。

　　proxy_send_timeout ：定义了Nginx向上游服务器发送请求的超时时间。

　　proxy_read_timeout ： 定义了Nginx读取上游服务器响应的超时时间。

　　proxy_next_upstream ： 在指定的错误或超时发生时，Nginx会尝试将请求传递到下一个上游服务器，这里指定了会发生重试的错误类型。

 

 

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, server, location

• 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 # 禁用将请求传递给下一个服务器。

 

2. 重试配置

2.1 重试配置，方式1

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

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

proxy_next_upstream_timeout 语法：

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

语法：    proxy_next_upstream_timeout time;
默认：    proxy_next_upstream_timeout 0; 
使用位置：    http, server, location

 

proxy_next_upstream_tries 语法：

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

语法：    proxy_next_upstream_tries number;
默认：    proxy_next_upstream_tries 0;
使用位置：    http, server, location

 

2.2 重试配置，方式2

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

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

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

 

2.3 整合示例

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
}