nginx下各种超时时间的配置详细指南_Linux

在nginx中，设置超时时间主要是为了防止服务器资源被长时间占用，进而提升服务的可用性和响应速度。nginx中可以设置超时的配置项主要有以下几种：

client_header_timeout：设置客户端发送请求头的超时时间。
client_body_timeout：设置客户端发送请求体的超时时间。
send_timeout：设置服务器向客户端发送响应的超时时间。
proxy_connect_timeout：设置nginx代理服务器与上游服务器建立连接的超时时间。
proxy_read_timeout：设置nginx代理服务器从上游服务器读取数据的超时时间。
proxy_send_timeout：设置nginx代理服务器向上游服务器发送请求的超时时间。

我们来看一些具体的配置示例：

http {
    server {
        listen 80;
        
        # 设置客户端请求头部的超时时间为10秒
        client_header_timeout 10s;
        
        # 设置客户端请求体的超时时间为15秒
        client_body_timeout 15s;
        
        # 设置发送响应的超时时间为20秒
        send_timeout 20s;
        
        location / {
            proxy_pass http://upstream_server;
            
            # 设置代理连接超时时间为5秒
            proxy_connect_timeout 5s;
            
            # 设置代理读取超时时间为30秒
            proxy_read_timeout 30s;
            
            # 设置代理发送超时时间为25秒
            proxy_send_timeout 25s;
        }
    }
}

引言

nginx作为一款高性能的web服务器和反向代理服务器，提供了多种超时配置选项来优化连接管理和资源利用。本文将详细介绍nginx中的各种超时设置，并通过流程图帮助您理解这些配置的工作机制。

1. nginx超时配置概述

nginx的超时设置主要分为以下几类：

2. 客户端连接相关超时

2.1 client_header_timeout

设置读取客户端请求头的超时时间，默认60秒。

http {
    client_header_timeout 30s;
}

2.2 client_body_timeout

设置读取客户端请求体的超时时间，默认60秒。

http {
    client_body_timeout 30s;
}

2.3 send_timeout

设置向客户端发送响应的超时时间，默认60秒。

http {
    send_timeout 30s;
}

3. 代理相关超时

3.1 proxy_connect_timeout

设置与后端服务器建立连接的超时时间，默认60秒。

location / {
    proxy_connect_timeout 10s;
    proxy_pass http://backend;
}

3.2 proxy_read_timeout

设置从后端服务器读取响应的超时时间，默认60秒。

location / {
    proxy_read_timeout 30s;
    proxy_pass http://backend;
}

3.3 proxy_send_timeout

设置向后端服务器发送请求的超时时间，默认60秒。

location / {
    proxy_send_timeout 30s;
    proxy_pass http://backend;
}

4. fastcgi相关超时

4.1 fastcgi_connect_timeout

设置与fastcgi服务器建立连接的超时时间，默认60秒。

location ~ \.php$ {
    fastcgi_connect_timeout 10s;
    fastcgi_pass 127.0.0.1:9000;
}

4.2 fastcgi_read_timeout

设置从fastcgi服务器读取响应的超时时间，默认60秒。

location ~ \.php$ {
    fastcgi_read_timeout 30s;
    fastcgi_pass 127.0.0.1:9000;
}

4.3 fastcgi_send_timeout

设置向fastcgi服务器发送请求的超时时间，默认60秒。

location ~ \.php$ {
    fastcgi_send_timeout 30s;
    fastcgi_pass 127.0.0.1:9000;
}

5. 其他重要超时配置

5.1 keepalive_timeout

设置客户端与nginx保持连接的超时时间，默认75秒。

http {
    keepalive_timeout 65s;
}

5.2 resolver_timeout

设置dns解析的超时时间，默认30秒。

location / {
    resolver 8.8.8.8;
    resolver_timeout 10s;
    proxy_pass http://$host$request_uri;
}

5.3 lingering_timeout

设置客户端关闭连接后，nginx等待剩余数据的超时时间。

http {
    lingering_timeout 20s;
}

6. 超时配置最佳实践

生产环境推荐值：

代理相关超时：10-30秒
客户端相关超时：30-60秒
keepalive_timeout：15-30秒

根据应用类型调整：

api服务：较短的超时（5-15秒）
文件上传：较长的超时（300秒以上）

监控与调优：

7. 完整配置示例

http {
    # 客户端超时
    client_header_timeout 30s;
    client_body_timeout 30s;
    send_timeout 30s;
    
    # 保持连接
    keepalive_timeout 30s;
    
    # 代理超时
    proxy_connect_timeout 15s;
    proxy_read_timeout 30s;
    proxy_send_timeout 30s;
    
    # fastcgi超时
    fastcgi_connect_timeout 15s;
    fastcgi_read_timeout 30s;
    fastcgi_send_timeout 30s;
    
    # 其他
    resolver_timeout 10s;
    lingering_timeout 20s;
    
    server {
        listen 80;
        
        location / {
            proxy_pass http://backend;
        }
        
        location ~ \.php$ {
            fastcgi_pass 127.0.0.1:9000;
        }
    }
}