trisa/grpc-proxy

trisa/grpc-proxy镜像说明

镜像概述

trisa/grpc-proxy是基于Envoy代理构建的镜像，核心功能是实现grpc-web协议与grpc协议的转换，解决前端应用通过HTTP 1.1发送的grpc-web请求无法直接与后端HTTP 2协议的grpc服务通信的问题。

核心功能

• 协议转换：将grpc-web的HTTP 1.1请求转换为grpc的HTTP 2请求
• 通信适配：支持前端grpc-web客户端与后端grpc服务端的无缝交互
• 高性能转发：基于Envoy代理的高可靠性和低延迟特性，确保请求处理的效率

使用场景

• 前端应用采用grpc-web框架开发，需要与后端grpc服务进行数据交互时
• 在HTTP 1.1环境下需访问基于HTTP 2的grpc服务时

配置说明

该镜像依赖Envoy的配置文件，关键配置项包括：

1. 监听端口：设置代理接收grpc-web请求的端口（默认通常为8080）
2. 上游服务地址：配置后端grpc服务的地址和端口
3. 转换规则：定义HTTP 1.1到HTTP 2的协议转换逻辑

部署示例

Docker Run命令

bash
docker run -d -p 8080:8080 docker.xuanyuan.run/trisa/grpc-proxy

（注：实际部署需根据后端服务地址调整Envoy配置，可通过挂载自定义配置文件实现）

Docker Compose示例

yaml
version: '3'
services:
  grpc-proxy:
    image: trisa/grpc-proxy
    ports:
      - "8080:8080"
    volumes:
      - ./envoy-config.yaml:/etc/envoy/envoy.yaml  # 挂载自定义Envoy配置文件