Python中如何利用nginx原生支持gRPC

在Python里用nginx原生支持gRPC，核心是配置nginx作为gRPC服务的反向代理。nginx从1.13.10版本开始就内置了对gRPC的代理支持。

你需要一个基本的nginx配置文件，比如叫 grpc_nginx.conf。关键是用 listen 指令的 http2 参数来启用HTTP/2（gRPC的基础），然后在 location 块里用 grpc_pass 指向你的Python gRPC服务器地址。

这里是一个最简配置示例：

events {
    worker_connections 1024;
}

http {
    server {
        listen 50051 http2; # 监听50051端口，启用http2

        location / {
            grpc_pass grpc://localhost:50052; # 代理到本机50052端口的gRPC服务
        }
    }
}

假设你的Python gRPC服务跑在 localhost:50052。用这个命令启动nginx：

nginx -c /path/to/your/grpc_nginx.conf

Python这边，你需要用 grpc 包。下面是一个简单的服务端例子，实现一个 SayHello 方法：

from concurrent import futures
import grpc
import hello_pb2
import hello_pb2_grpc

class Greeter(hello_pb2_grpc.GreeterServicer):
    def SayHello(self, request, context):
        return hello_pb2.HelloReply(message=f'Hello, {request.name}!')

def serve():
    server = grpc.server(futures.ThreadPoolExecutor(max_workers=10))
    hello_pb2_grpc.add_GreeterServicer_to_server(Greeter(), server)
    server.add_insecure_port('[::]:50052') # 服务监听50052端口
    server.start()
    server.wait_for_termination()

if __name__ == '__main__':
    serve()

对应的 hello.proto 文件内容：

syntax = "proto3";

package hello;

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}

用 grpc_tools.protoc 生成 hello_pb2.py 和 hello_pb2_grpc.py 文件：

python -m grpc_tools.protoc -I. --python_out=. --grpc_python_out=. hello.proto

客户端调用时需要指定nginx代理的地址（localhost:50051）：

import grpc
import hello_pb2
import hello_pb2_grpc

def run():
    with grpc.insecure_channel('localhost:50051') as channel: # 连接到nginx
        stub = hello_pb2_grpc.GreeterStub(channel)
        response = stub.SayHello(hello_pb2.HelloRequest(name='World'))
        print(f"Greeter client received: {response.message}")

if __name__ == '__main__':
    run()

这样，客户端请求 localhost:50051，nginx收到后转发给 localhost:50052 的真实服务，再把响应返回给客户端。这种架构的好处是nginx可以帮你做负载均衡、TLS终止、访问日志等，而你的Python服务只需专注业务逻辑。

总结：配好nginx的grpc_pass，让流量走代理就行。

示例代码 greeter_cient_timeit.py 中，提供了对比测试，HTTP/2.0 的多路复用大约能节省一半的时间。

出 grpc 支持能更好的驱动 ngmesh，这是我个人比较看好的。因为之前基本上就 envoy 可以选择。

另外的就是做 GRPC API Gateway 也多了个选择