proxy_connect_timeout

该 `proxy_connect_timeout` 指令用于配置等待与被代理服务器建立连接的最长时间。

语法proxy_connect_timeout time;
默认值60s
上下文
参数1

说明

在 NGINX SRT 模块中,proxy_connect_timeout 指令在管理对上游服务器的连接尝试超时时发挥着关键作用。该指令指定了 NGINX 在对被代理服务器建立连接成功之前等待的时间段,超过该时长则会超时。当该时长被超过时,将返回错误,从而避免 NGINX 在尝试连接可能不可达的服务器时无限期挂起。

该指令接受一个参数,用于指定超时时长。格式可以为秒(例如 30s),也可以使用时间单位表示,例如 m 表示分钟,h 表示小时等。如果未指定,则使用服务器配置中的预定义值。应根据网络环境合理配置该超时,以优化应用的可靠性和性能。

对于具有动态上游服务器或网络延迟波动的场景,调整 proxy_connect_timeout 可以显著改善用户体验,减少等待时间,并在主服务器不可用时允许快速故障切换到备用代理。

配置示例

server {
    listen 4321;
    proxy_connect_timeout 30s;
    proxy_pass tcp://127.0.0.1:5678;
}

将超时设置得过低可能导致连接过早失败,尤其在高延迟网络中。

如果使用 HTTP/1.1 或 keep-alive 连接,请确保该超时与其他超时设置保持平衡,以防止意外中断。

← 返回所有指令