@TOC

前言

 沟通服务间接口内容(尤其是前后端接口)，是非常让人头疼的事。极其容易扯皮。接口文档写起来也很痛苦，每个字段的改动都需要及时更新，否则就会出问题。服务端通信如果用rpc通信的话，一般会有proto或者thrift文件。这个文件很长时间里被我们当成接口文档用，用着用着发现，真tm好用。既减少了扯皮，还不用写接口文档。那可不可以用grpc和前端通信那，一开始我们的做法是用grpc-gateway。把grpc的接口映射成http接口。但这种方式需要编译gateway的pb文件，对服务也是有侵入的。后来随着我在公司的时间越来越长，接手的服务越来越多(经常需要发版的项目就有十几个)，这种方式维护起来十分糟心，后一直想寻求一种一劳永逸的解决方法？

 本人之前很长一段时间从事saas，paas的开发。对于一些服务而言，既要提供grpc访问的能力，也要对外提供http访问的能力(做saas就是这么卑微)。并且这种需求通常不是一开始就提出来的，而是对一个已经稳定运行的庞大的服务做改造。而这会导致爬屎山，鉴权不一致等一系列问题。那有没有一种无侵入的协议转换能力？

  grpc是基于http2协议，而http2是长连接。这对k8s部署的服务非常不友好。在这我猜肯定有很多小伙伴说可以用linked,istio等基于Service Mesh的解决方案。一是这些技术是近两年才稳定下来的，以前问题很多，根本不敢用，当然现在istio已经流行起来了，可以很完美的做到grpc的负载均衡和很优秀的流量管理。但依然存在不满足实际需求的情况，比如对grpc流量做精细过滤，细到每个请求的精准控制。这种二次开发的需求是很难在istio上完成。尤其是对一些小公司而言。 基于很多原因的考虑，最终诞生了搞一个grpc动态代理的想法，并初步实现。

grpc

  在云原生，容器化，微服务的大背景下。rpc也彻底奠定了服务间通信协议的霸主地位。众多rpc框架中grpc和thrift是最流行最受欢迎的rpc框架。在实际开发中，我两个框架都有深入的使用过。相较而言，我更喜欢grpc的风格。背靠google大树(已经是CNCF孵化项目)，多语言都支持，基于protobuf极致编码和急速传输，等等优点就不一一详述。有兴趣的可以看grpc官网，上面吹的比我吹的好。

实践

github地址

https://github.com/woshihaoren4/grpc-proxy

第一步

先将代码clone下来到本地，我这里用的mac系统 因为编译需要cargo环境，需要先安装rust，参考教程：https://www.rust-lang.org/zh-CN/ 上面有很详细的中文教程。 我安装的是：rustc 1.66.0 (69f9c33d7 2022-12-12) 版本

第二步

先进入项目根目录，运行起测试例子

./example/helloworld server

没有权限的话，需要先加权限，然后再运行
chmod +x ./example/helloworld

这个例子使用golang编写的简单的grpc服务，实现上没有啥特殊的部分，值得注意的是需要给grpc服务加上反射

//grpc的HelloWorld方法实现，就是在字符串上加一个 world
func (s *Service) HelloWorld(ctx context.Context, req *proto.HelloWorldRequest) (*proto.HelloWorldResponse, error) {
        return &proto.HelloWorldResponse{Response: req.Request + " world"}, nil
}
//这里相当于main函数
func server(ctx *wdevent.Context) error {
        ls, _ := net.Listen("tcp", ":8888")
        gs := grpc.NewServer()
        proto.RegisterHelloWorldServiceServer(gs, new(Service))
        reflection.Register(gs)
        logrus.Infoln("grpc server start workd ....")
        gs.Serve(ls)
        return nil
}

再看一下pb文件，需要注意的是在option里指明 需要映射的http的路径和方法

syntax = "proto3";

package proto;
option go_package = "./proto";
import "google/api/annotations.proto";

// HelloWorld Service
service HelloWorldService {
  rpc HelloWorld(HelloWorldRequest) returns (HelloWorldResponse){
    option (google.api.http) = {
      post: "/api/v2/hello"
      body: "*"
    };
  };
}
message HelloWorldRequest {
  string request = 1;
}
message HelloWorldResponse {
  string response = 1;
}

第三步

修改配置文件如下，路径：./src/config/config.toml。当前项目中的配置文件已经写好了这些内容，不需要再配置什么了。当然不放心也可以查看一下。

[[proxy_sink]]
name = "hello"
addr = "127.0.0.1:8888"

• 需要在addr中指明上面服务的地址和端口。

第四步

另起终端，编译并运行项目

cargo run -- run

国内没有科学上网的话会有些慢，主要是下载包比较慢，可以用清华源或者其他的，教程参考：https://www.w3cschool.cn/cargo_guide/cargo_guide-uxdg3l62.html 服务启动后会打印如下日志，说明服务启动成功

测试

发起一个http请求

curl --location --request POST 'http://127.0.0.1:6789/api/v2/hello' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request": "hello"
}'

可以看到返回内容：{"response": "hello world"} 并且在代理服务上产生访问日志： 到这里一个简单的演示就成功了

结构和原理

主要是根据grpc的反射的描述，生成http路由，并动态完成json和proto的映射。 更进一步的原理和结构，未完待续~

尾语

当前版本还只是一个比较初级的版本，功能还很初级。 还有很多功能需要完善，架构也可能会有大的变动，所有上一节并没有详细描述。 作者预计但不承诺会继续完成下面的内容。

• restful支持：这个功能是P0级，在我go版本的grpc动态代理服务中经常被用到，在可预计的规划里一定会实现。
• 事件系统：该功能是为了方便二次开发，很有必要。也有可能用中间件模式，类似traefik
• 负载均衡/sidecar：负载均衡是为了用在服务网关上，sidecar是用在pod里，二者会选一个实现，我倾向于前者，和我之前写的rust-ingress联动上。这里自荐一波rust-ingress项目：https://gitee.com/yutiandou/rust-ingress
• 性能优化，这个会一直持续做下去，欢迎有性能极致追求的小伙伴能够共同前进
• 实时反射：目前是通过配置文件，在启动的时候加载服务源。好的(懒人)方案是proto文件变化后能够实时监控到，下一步会完成这个功能。

欢迎有兴趣的小伙伴提出建议，并热烈欢迎大家参与进来。