如何配置超时?¶

Envoy 支持多种超时，用户可根据部署情况进行相应的配置。本页总结了在各种场景中使用的最重要的超时。

Attention

本文并未列出所有 Envoy 支持的超时配置。根据部署情况，可能需要额外的配置。

HTTP/gRPC¶

连接超时适用于整个 HTTP 连接和连接承载的所有流。

HTTP 协议中的 idle timeout 是在 HTTP 连接管理器和上游集群 HTTP 连接使用的通用消息中定义的。空闲超时是在没有活动流的情况下，终止下游或上游连接的时间。如果没有指定，默认空闲超时时间为 1 小时。要修改下游连接的空闲超时时间，请使用 HTTP 连接管理器配置中的 common_http_protocol_options 字段。要修改上游连接的空闲超时时间，请使用集群配置中的 common_http_protocol_options 字段。

流超时适用于 HTTP 连接承载的单个流。请注意，流是 HTTP/2 和 HTTP/3 的概念，然而 Envoy 在内部将 HTTP/1 请求映射到流，因此在这种情况下，请求/流是可以互换的。

HTTP 连接管理器中的 request_timeout 是连接管理器允许从客户端接收 整个请求流 的时间。

Attention

默认情况下，请求超时不是必须配置的，因为它与流请求（请求永不结束）不兼容。请查阅随后的流空闲超时。然而，如果使用缓冲区过滤器，建议配置请求超时。
HTTP 连接管理器中的 stream_idle_timeout 是连接管理器允许流在没有下游或上游活动时所能存在的时间。默认流空闲超时时间为 5 分钟。强烈建议对所有请求（不仅仅是流请求/响应）配置流空闲超时，因为它可以防止一旦将整个响应缓存发送给下游客户端，使用 HTTP/2 的客户端不会关闭流窗口。
HTTP 协议中的 max_stream_duration 是在 HTTP 连接管理器的通用消息中定义的。最大流持续时间是一个流的生命周期的最大时间。当需要定期重置 HTTP 请求/响应流时，可以使用此功能。在这种情况下，你不能使用 request_timeout ，因为如果在请求/响应流中收到响应头，定时器将会被重置。该超时在上游和下游连接上都可用。

Envoy 另外还支持路由级别的流超时，可以覆盖上面已经介绍的一些流超时。

路由超时是 Envoy 等待上游完成响应的时间。此超时在接收到整个下游请求流之前不会启动。

Attention

该超时默认为 15 秒，然而它与流响应（响应永不结束）不兼容，需要禁用。流空闲超时应当在流 API 中使用，如本页在其他位置所描述的一样。
路由 idle_timeout 允许覆盖 HTTP 连接管理器中的 stream_idle_timeout ，并执行相同的动作。
在使用重试时，可以配置路由 per_try_timeout ，使得每次请求使用的超时时间比前面描述的总体请求超时时间更短。该超时仅在响应的任何部分发送到下游之前才适用，通常发生在上游发送响应头之后。如果上游在超时时间内无法响应，则可以使用该超时来重试流端点。
路由 MaxStreamDuration proto 可以用来覆盖 HTTP 连接管理器中单个路由的 max_stream_duration ，也可以在 grpc-timeout 报头上设置限制和固定的时间偏移量。

集群 connect_timeout 指的是 Envoy 等待上游建立 TCP 连接的时间。该超时没有默认值，但是是必须配置的。

Attention

对于 TLS 连接，连接超时包括 TLS 握手。
TCP 代理 idle_timeout 指的是 TCP 代理允许连接在没有下游或上游活动时，所能存在的时间。如果没有指定，默认的空闲超时时间是 1 小时。