scarmuega/grpcwebproxy

scarmuega/grpcwebproxy 镜像说明

镜像概述

scarmuega/grpcwebproxy是一个多架构Docker镜像，封装了@improbable-eng开发的grpcwebproxy工具。它解决了Web浏览器无法直接调用gRPC服务的问题，通过协议转换实现前端应用与后端gRPC服务的通信，支持多种CPU架构（如amd64、arm64），适配不同部署环境。

核心功能

1. 多架构兼容：支持多种CPU架构，可在服务器、嵌入式设备等平台运行。
2. 协议转换：将Web端HTTP请求转为gRPC请求转发至后端，同时将gRPC响应转为HTTP响应返回。
3. 跨域支持：可配置允许的跨域来源，解决前端跨域访问问题。
4. 流式传输：支持gRPC的服务器流式、客户端流式及双向流式传输特性。

使用场景

1. 前端访问gRPC服务：Web前端需要调用后端gRPC服务时，部署该代理作为中间层。
2. 多架构环境部署：在混合架构系统（如x86服务器、ARM设备）中统一使用该镜像。
3. 开发调试：快速搭建gRPC服务的Web访问代理，简化开发流程。

配置说明

通过命令行参数配置，常用参数：

• --backend_addr：后端gRPC服务地址（格式：host:port）。
• --listen_addr：代理监听地址（格式：host:port）。
• --allow_all_origins：允许所有跨域来源（开发环境常用）。
• --cors_allowed_origins：指定允许的跨域来源（多个用逗号分隔）。

部署示例

Docker Run命令

bash
docker run -d -p 8080:8080 \
  scarmuega/grpcwebproxy \
  --backend_addr=your-grpc-service:50051 \
  --listen_addr=0.0.0.0:8080 \
  --allow_all_origins

Docker Compose示例

yaml
version: '3'
services:
  grpcwebproxy:
    image: scarmuega/grpcwebproxy
    ports:
      - "8080:8080"
    command: 
      - "--backend_addr=grpc-service:50051"
      - "--listen_addr=0.0.0.0:8080"
      - "--allow_all_origins"
    depends_on:
      - grpc-service
  grpc-service:
    image: your-grpc-service-image
    ports:
      - "50051:50051"