grpc-proxy

通过 APISIX 代理 gRPC 连接,并使用 APISIX 的大部分特性管理你的 gRPC 服务。

参数

  • service_protocol: 这个 Route 的属性 service_protocol 必须设置为 grpc
  • uri: 格式为 /service/method 如:/helloworld.Greeter/SayHello

示例

创建代理 gRPC 的 Route

在指定 Route 中,代理 gRPC 服务接口:

  • 注意: 这个 Route 的属性 service_protocol 必须设置为 grpc
  • 注意: APISIX 使用 TLS 加密的 HTTP/2 暴露 gRPC 服务, 所以需要先 配置 SSL 证书
  • 下面例子所代理的 gRPC 服务可供参考:grpc_server_example
  1. curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
  2. {
  3. "methods": ["POST", "GET"],
  4. "uri": "/helloworld.Greeter/SayHello",
  5. "service_protocol": "grpc",
  6. "upstream": {
  7. "type": "roundrobin",
  8. "nodes": {
  9. "127.0.0.1:50051": 1
  10. }
  11. }
  12. }'

测试

访问上面配置的 Route:

  1. grpcurl -insecure -import-path /pathtoprotos -proto helloworld.proto \
  2. -d '{"name":"apisix"}' 127.0.0.1:9443 helloworld.Greeter.SayHello
  3. {
  4. "message": "Hello apisix"
  5. }

这表示已成功代理。