Xray-docs-next/docs/config/transports/grpc.md

gRPC

基于 gRPC 的传输方式。

它基于 HTTP/2 协议，理论上可以通过其它支持 HTTP/2 的服务器（如 Nginx）进行中转。 gRPC（HTTP/2）内置多路复用，不建议使用 gRPC 与 HTTP/2 时启用 mux.cool。

::: warning ⚠⚠⚠

• gRPC 不支持指定 Host。请在出站代理地址中填写 正确的域名 ，或在 (x)tlsSettings 中填写 ServerName，否则无法连接。
• gRPC 不支持回落到其他服务。
• gRPC 服务存在被主动探测的风险。建议使用 Caddy 或 Nginx 等反向代理工具，通过 Path 前置分流。 :::

::: tip 如果您使用 Caddy 或 Nginx 等反向代理，请注意下列事项：

• 请确定反向代理服务器开启了 HTTP/2
• 请使用 HTTP/2 或 h2c (Caddy)，grpc_pass (Nginx) 连接到 Xray。
• 普通模式的 Path 为 /${serviceName}/Tun, Multi 模式为 /${serviceName}/TunMulti :::

::: tip 如果你正在使用回落，请注意下列事项：

• 不建议回落到 gRPC，存在被主动探测的风险。
• 请确认h2 位于 (x)tlsSettings.alpn 中的第一顺位，否则 gRPC（HTTP/2）可能无法完成 TLS 握手。
• gRPC 无法通过进行 Path 分流。 :::

GRPCObject

GRPCObject 对应传输配置的 grpcSettings 项。

{
  "serviceName": "name",
  "multiMode": false,
  "idle_timeout": 10,
  "health_check_timeout": 20,
  "permit_without_stream": false
}

serviceName: string

一个字符串，指定服务名称，类似于 HTTP/2 中的 Path。 客户端会使用此名称进行通信，服务端会验证服务名称是否匹配。

multiMode: bool

一个布尔值。表示是否启用 multiMode。

这是一个 实验性 选项，可能不会被长期保留，也不保证跨版本兼容。此模式在 测试环境中 能够带来约 20% 的性能提升，实际效果因传输速率不同而不同。

idle_timeout: number

单位秒，当这段时间内没有数据传输时，将会进行健康检查。如果此值设置为 10 以下，将会使用 10，即最小值。

健康检查默认不启用。

仅需在客户端配置。

health_check_timeout: number

单位秒，健康检查的超时时间。如果在这段时间内没有完成健康检查，且仍然没有数据传输时，即认为健康检查失败。默认值为 20。

permit_without_stream: bool

设置为 true 时，将允许在没有子连接时进行健康检查。默认值为 false。