Nginx timeout配置详解

最新推荐文章于 2025-06-25 18:34:20 发布

原创

最新推荐文章于 2025-06-25 18:34:20 发布 · 1.1k 阅读

1 ·

CC 4.0 BY-SA版权

本文详细解析了Nginx中与超时相关的配置参数，包括keepalive_timeout、send_timeout、proxy_connect_timeout、proxy_read_timeout、proxy_send_timeout以及so_timeout。这些设置对保持HTTP连接、处理客户端和上游服务器的通信超时至关重要，有效管理资源并防止504 Gateway Time-out错误。

最近项目中用到了nginx，后台用的是Java, 发现有一个请求后台处理操过了1分钟，结果请求Status Code为504 Gateway Time-out.

理解了下nginx 所有timeout相关的配置，如下：

keepalive_timeout

HTTP 有一个 KeepAlive 模式，它告诉 webserver 在处理完一个请求后保持这个 TCP 连接的打开状态。若接收到来自客户端的其它请求，服务端会利用这个未被关闭的连接，而不需要再建立一个连接。

http keep-alive, 網頁的每一個請求都是HTTP (圖片, CSS等), 而打開HTTP 請求是要先建立TCP 連接, 而如果一個頁面每個請求都要打開及關閉一個TCP 連接就會做成資源的浪費. keepalive_timeout 就是當一個HTTP 請求完成, 其TCP 連接會存留下來的時間, 如果這時有另一個HTTP 請求過來, 會複用這個TCP 連接, 如果再沒有新的請求過來, 才會關閉其TCP連接


user  nginx;
worker_processes  1;

error_log  /var/log/nginx/error.log warn;
pid        /var/run/nginx.pid;


events {
    worker_connections  1024;
}


http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$h