fullstorydev/grpcui

grpcui Docker镜像文档

镜像概述和主要用途

grpcui Docker镜像是一个用于探索和调用gRPC方法的Web UI工具，基于fullstorydev/grpcui项目构建。该镜像运行在8080端口的Web服务器上，提供图形化界面以简化gRPC服务的交互过程，帮助用户无需编写代码即可可视化探索服务定义并执行方法调用。

核心功能和特性

• 交互式Web界面：通过浏览器访问，直观展示gRPC服务元数据、方法列表及参数结构
• gRPC方法调用：支持输入请求参数，执行gRPC方法调用并实时查看响应结果
• 端口映射：默认使用8080端口提供Web服务，便于快速访问和集成
• 轻量级部署：容器化封装，无需复杂环境配置，可快速启动使用

使用场景和适用范围

• gRPC服务开发调试：开发人员在开发阶段验证gRPC服务接口功能和正确性
• 测试验证：测试人员通过图形界面便捷地构造请求、测试边界条件
• 服务文档查阅：团队成员快速了解gRPC服务提供的方法和数据结构

使用方法和配置说明

基本运行命令

通过以下命令启动容器，需指定目标gRPC服务地址：

bash
docker run -p 8080:8080 docker.xuanyuan.run/fullstorydev/grpcui --addr=grpc-service:50051

说明：--addr=grpc-service:50051 需替换为实际gRPC服务的地址和端口

非TLS连接配置

若目标gRPC服务未启用TLS加密，添加--plaintext参数：

bash
docker run -p 8080:8080 docker.xuanyuan.run/fullstorydev/grpcui --addr=grpc-service:50051 --plaintext

自定义Web服务端口

如需修改Web UI监听端口，使用--server-addr参数指定：

bash
docker run -p 8888:8888 docker.xuanyuan.run/fullstorydev/grpcui --addr=grpc-service:50051 --server-addr=0.0.0.0:8888

访问Web界面

容器启动后，通过浏览器访问 http://localhost:8080（或自定义端口）即可打开grpcui界面，在界面中可:

1. 查看gRPC服务列表和方法定义
2. 填写请求参数并点击"Invoke"执行调用
3. 在响应区域查看调用结果

源代码

项目完整信息和最新版本请参考：https://github.com/fullstorydev/grpcui