diff --git a/docs/config/transports/grpc.md b/docs/config/transports/grpc.md index f31001b..f154bf5 100644 --- a/docs/config/transports/grpc.md +++ b/docs/config/transports/grpc.md @@ -38,7 +38,8 @@ gRPC(HTTP/2)内置多路复用,不建议使用 gRPC 与 HTTP/2 时启用 m "multiMode": false, "idle_timeout": 10, "health_check_timeout": 20, - "permit_without_stream": false + "permit_without_stream": false, + "initial_windows_size": 0 } ``` @@ -53,18 +54,42 @@ gRPC(HTTP/2)内置多路复用,不建议使用 gRPC 与 HTTP/2 时启用 m 这是一个 **实验性** 选项,可能不会被长期保留,也不保证跨版本兼容。此模式在 **测试环境中** 能够带来约 20% 的性能提升,实际效果因传输速率不同而不同。 +注:**只需**在**出站**(**客户端**)配置。 + > `idle_timeout`: number 单位秒,当这段时间内没有数据传输时,将会进行健康检查。如果此值设置为 `10` 以下,将会使用 `10`,即最小值。 +::: tip +设为 `60` 以下,服务端可能发送意外的 h2 GOAWAY 帧以关闭现有连接。 +::: + 健康检查默认**不启用**。 -仅需在**客户端**配置。 +注:**只需**在**出站**(**客户端**)配置。 + +::: tip +可能会解决一些“断流”问题。 +::: > `health_check_timeout`: number 单位秒,健康检查的超时时间。如果在这段时间内没有完成健康检查,且仍然没有数据传输时,即认为健康检查失败。默认值为 `20`。 +注:**只需**在**出站**(**客户端**)配置。 + > `permit_without_stream`: true | false `true` 允许在没有子连接时进行健康检查。默认值为 `false`。 + +注:**只需**在**出站**(**客户端**)配置。 + +> `initial_windows_size`: number + +h2 Stream 初始窗口大小。当值小于等于 `0` 时,此功能不生效。当值大于 `65535` 时,动态窗口机制(Dynamic Window)会被禁用。默认值为 `0`,即不生效。 + +注:**只需**在**出站**(**客户端**)配置。 + +::: tip +通过 Cloudflare CDN 时,可将值设为 `524288`,即禁用动态窗口机制(Dynamic Window),可防止 Cloudflare CDN 发送意外的 h2 GOAWAY 帧以关闭现有连接。 +:::