From fdf839909224727ca5c1fbaea2d70fe307fd6c4e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E3=81=A1=E3=81=8B?=
<88967758+chika0801@users.noreply.github.com>
Date: Wed, 27 Mar 2024 12:43:10 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=20authority=20=E8=A7=A3?=
=?UTF-8?q?=E9=87=8A=EF=BC=8C=E8=A1=A5=E5=85=85=20serverName=20=E8=B5=B7?=
=?UTF-8?q?=E5=A7=8B=E4=B8=BA=E6=96=9C=E6=9D=A0=E6=97=B6=E7=9A=84=E8=A6=81?=
=?UTF-8?q?=E6=B1=82=20(#493)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/config/transports/grpc.md | 7 ++++++-
1 file changed, 6 insertions(+), 1 deletion(-)
diff --git a/docs/config/transports/grpc.md b/docs/config/transports/grpc.md
index 3616902b5..366333f6c 100644
--- a/docs/config/transports/grpc.md
+++ b/docs/config/transports/grpc.md
@@ -35,6 +35,7 @@ gRPC(HTTP/2)内置多路复用,不建议使用 gRPC 与 HTTP/2 时启用 m
```json
{
+ "authority": "grpc.example.com",
"serviceName": "name",
"multiMode": false,
"user_agent": "custom user agent",
@@ -45,13 +46,17 @@ gRPC(HTTP/2)内置多路复用,不建议使用 gRPC 与 HTTP/2 时启用 m
}
```
+> `authority`: string
+
+一个字符串,可以当 Host 来用,实现一些其它用途。
+
> `serviceName`: string
一个字符串,指定服务名称,**类似于** HTTP/2 中的 Path。
客户端会使用此名称进行通信,服务端会验证服务名称是否匹配。
::: tip
-当 `serviceName` 起始为斜杠时可以自定义 path。
+当 `serviceName` 起始为斜杠时可以自定义 path,至少要两个斜杠。
例如在服务端填写 `"serviceName": "/my/sample/path1|path2"`,客户端可填写 `"serviceName": "/my/sample/path1"` 或 `"/my/sample/path2"`。
:::