Nginx 中 proxy_connect_timeout 指令有什么作用？

推荐答案

proxy_connect_timeout 指令用于设置 Nginx 与后端服务器建立连接的超时时间。如果在指定的时间内未能成功建立连接，Nginx 将返回一个错误响应。

本题详细解读

作用

proxy_connect_timeout 指令定义了 Nginx 在尝试与后端服务器建立 TCP 连接时的最大等待时间。这个时间是从 Nginx 开始尝试连接到后端服务器开始计算的，如果在指定的时间内未能成功建立连接，Nginx 将停止尝试并返回一个错误响应。

语法

proxy_connect_timeout time;

• time：超时时间，单位可以是秒（s）或毫秒（ms）。默认单位是秒。

默认值

默认情况下，proxy_connect_timeout 的值为 60 秒。

示例

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

在这个示例中，Nginx 会在 5 秒内尝试与后端服务器建立连接。如果 5 秒内未能成功建立连接，Nginx 将返回一个错误响应。

注意事项

• 该指令仅影响与后端服务器建立连接的时间，不影响数据传输的时间。
• 如果后端服务器响应较慢或网络延迟较高，建议适当增加该值以避免频繁超时。
• 该指令通常与 proxy_send_timeout 和 proxy_read_timeout 一起使用，以全面控制代理请求的超时行为。