proxy_connect_timeout

proxy_connect_timeout 指令设置与被代理服务器建立连接的超时时间。 — NGINX HTTP Core

proxy_connect_timeout
httpserverlocation
语法proxy_connect_timeout time;
默认值60s
上下文http, server, location
模块NGINX HTTP Core
参数1

说明

`proxy_connect_timeout` 指令指定从 NGINX 服务器到被代理服务器建立成功连接的时间上限。对于被代理服务器可能处于高负载或无响应的场景,这一点尤其有用。如果在指定的超时时间内无法建立连接,NGINX 将向客户端返回错误,从而有效避免客户端无限期挂起。 该指令可以在不同的上下文中定义,例如 `http`、`server` 和 `location`,从而在不同配置范围内对超时设置进行细粒度控制。设置此超时有助于改进故障切换处理并协助有效管理资源分配,确保 NGINX 不会在无响应的上游端点上浪费时间。超时值通常以时间单位格式指定(例如 `10s`、`1m`)。

配置示例

http {
    proxy_connect_timeout 30s;
    server {
        location / {
            proxy_pass http://backend;
        }
    }
}

该超时仅适用于连接建立阶段,并不影响连接建立后数据传输所需的时间。

将超时设置得非常低可能导致过早断开连接,尤其是在上游服务器响应缓慢时。