nginx常用超时设置

秒速五厘米 2022-08-20 03:18 321阅读 0赞

\# 客户度连接nginx超时, 建议5s内  
  
\# 接收客户端header超时, 默认60s, 如果60s内没有收到完整的http包头, 返回408  
Syntax: client\_header\_timeout time;  
Default:      
client\_header\_timeout 60s;  
Context:    http, server  
Defines a timeout for reading client request header. If a client does not transmit the entire header within this time,   
the 408 (Request Time-out) error is returned to the client.  
  
  
\# 接收客户端body超时, 默认60s, 如果连续的60s内没有收到客户端的1个字节, 返回408  
Syntax: client\_body\_timeout time;  
Default:      
client\_body\_timeout 60s;  
Context:    http, server, location  
Defines a timeout for reading client request body. The timeout is set only for a period between two successive read operations, not for the transmission of the whole request body.

If a client does not transmit anything within this time,   
the 408 (Request Time-out) error is returned to the client.  
  
  
\# keepalive时间，默认75s，通常keepalive\_timeout应该比client\_body\_timeout大  
Syntax: keepalive\_timeout timeout \[header\_timeout\];  
Default:      
keepalive\_timeout 75s;  
Context:    http, server, location  
The first parameter sets a timeout during which a keep-alive client connection will stay open on the server side. The zero value disables keep-alive client connections.

The optional second parameter sets a value in the “Keep-Alive: timeout=time” response header field. Two parameters may differ.  
  
The “Keep-Alive: timeout=time” header field is recognized by Mozilla and Konqueror. MSIE closes keep-alive connections by itself in about 60 seconds.  
  
  
\# 可以理解为TCP连接关闭时的SO\_LINGER延时设置，默认5s  
Syntax: lingering\_timeout time;  
Default:      
lingering\_timeout 5s;  
Context:    http, server, location  
When lingering\_close is in effect, this directive specifies the maximum waiting time for more client data to arrive. If data are not received during this time,

the connection is closed. Otherwise, the data are read and ignored, and nginx starts waiting for more data again.

The “wait-read-ignore” cycle is repeated, but no longer than specified by the lingering\_time directive.  
  
  
\# 域名解析超时，默认30s  
Syntax: resolver\_timeout time;  
Default:      
resolver\_timeout 30s;  
Context:    http, server, location  
Sets a timeout for name resolution, for example:  
  
resolver\_timeout 5s;  
  
  
\# 发送数据至客户端超时, 默认60s, 如果连续的60s内客户端没有收到1个字节, 连接关闭  
Syntax: send\_timeout time;  
Default:      
send\_timeout 60s;  
Context:    http, server, location  
Sets a timeout for transmitting a response to the client. The timeout is set only between two successive write operations,   
not for the transmission of the whole response. If the client does not receive anything within this time, the connection is closed.  
  
\# nginx与upstream server的连接超时时间  
Syntax: proxy\_connect\_timeout time;  
Default:      
proxy\_connect\_timeout 60s;  
Context:    http, server, location  
Defines a timeout for establishing a connection with a proxied server. It should be noted that this timeout cannot usually exceed 75 seconds.  
  
  
\# nginx接收upstream server数据超时, 默认60s, 如果连续的60s内没有收到1个字节, 连接关闭  
Syntax: proxy\_read\_timeout time;  
Default:      
proxy\_read\_timeout 60s;  
Context:    http, server, location  
Defines a timeout for reading a response from the proxied server. The timeout is set only between two successive read operations,

not for the transmission of the whole response. If the proxied server does not transmit anything within this time, the connection is closed.  
  
  
\# nginx发送数据至upstream server超时, 默认60s, 如果连续的60s内没有发送1个字节, 连接关闭  
Syntax: proxy\_send\_timeout time;  
Default:      
proxy\_send\_timeout 60s;  
Context:    http, server, location  
Sets a timeout for transmitting a request to the proxied server. The timeout is set only between two successive write operations,

not for the transmission of the whole request. If the proxied server does not receive anything within this time, the connection is closed.

补充：

1，详细阅读ngx\_http\_upstream\_module模块配置说明  
1.1 关注摘点机制，默认是10秒1次失败则摘点，max\_fails/fail\_timeout/backup  
1.2 当节点被摘除后，该节点在一个fail\_timeout周期内不可用  
1.3 以nginx 1.11.2.5版为例，当所有节点被剔除，会返回HTTP 502

2，详细阅读ngx\_http\_proxy\_module模块配置说明  
2.1 关注超时/重试机制，默认不重试，需要配置proxy\_next\_upstream  
2.2 也可以限制尝试总次数proxy\_next\_upstream\_tries  
2.3 POST请求默认不会被重试，需要设置non\_idempotent

3，需要理解ngx\_http\_proxy\_module模块读写超时设置  
3.1 proxy\_connect\_timeout，针对一次请求；  
3.2 proxy\_read\_timeout，针对一次数据读行为，而不是整个请求的超时；  
3.3 proxy\_send\_timeout，针对一次数据写行为，而不是整个请求的超时；

4， 需要理解总超时，n次重试不能超过此阀值（ngx\_http\_proxy\_module模块）  
4.1 proxy\_next\_upstream\_timeout

更多超时限制参考官方文档：  
http://nginx.org/en/docs/