详细说明
优势 5 项
用 1 条命令调用 gRPC 服务,无需生成客户端代码
支持反射模式,可直接列出 2 类以上服务与方法信息
兼容 JSON 输入输出,与 REST 工具的 2 类使用习惯衔接
支持 TLS、mTLS 与自定义头,覆盖 3 类常见鉴权场景
以 BSD 许可开源,1 个单二进制即可跨平台运行
不足 4 项
仅面向 gRPC,不支持 REST 与 GraphQL
流式调用参数较多,学习成本偏高
无图形界面,团队共享用例不便
依赖服务端开启反射或提供 proto 文件
服务商概述
grpcurl 是 Fullstory 开源的 gRPC 命令行客户端,用类似 curl 的方式调用 gRPC 服务。
在开发工具分类里,它属于「接口调试工具」:补齐 gRPC 生态缺少轻量命令行客户端的空白。
核心优势
- 零代码调用:1 条命令发起请求
- 反射支持:无需 proto 也可探索
- JSON 友好:输入输出易读
- 鉴权覆盖:TLS 与 mTLS 可用
- 单二进制:部署无依赖
产品生态
平台能力
服务与方法列举、请求描述、一元与流式调用、JSON 与 proto 双向转换、TLS 与头部配置、以及错误码详情解析。
集成
可与 kubectl 端口转发、Docker、CI 脚本以及服务网格调试流程配合。
典型场景
微服务接口排查、gRPC 服务冒烟测试、Kubernetes 内服务验证、认证链路调试。
不足之处
- 协议范围:仅 gRPC
- 学习成本:流式调用参数较多
- 无 GUI:团队共享不便
- 前置条件:需反射或 proto
适用场景
- gRPC 快速排查(★★★★★):核心场景
- 集群内服务验证(★★★★☆):配合端口转发很顺手
- CI 冒烟测试(★★★★☆):脚本化容易
- REST 接口调试(★☆☆☆☆):不适用
价格参考
| 项目 | 价格 | 备注 |
|---|---|---|
| grpcurl | $0 | BSD 许可,开源免费 |
| 安装方式 | $0 | brew、go install、二进制下载 |
| 使用成本 | $0 | 无许可或席位限制 |
常见问题
服务没有开启反射怎么办?
可以通过 -proto 指定 proto 文件或导入路径。
支持流式调用吗?
支持客户端流、服务端流与双向流。
能在 Kubernetes 里用吗?
常配合 kubectl port-forward 使用,也可在 Pod 内直接调用。
与 grpcui 的关系?
grpcui 提供图形界面,二者同属一个项目家族。
代码示例
# 列出服务(需服务端开启反射)
grpcurl -plaintext localhost:50051 list
# 描述某个方法
grpcurl -plaintext localhost:50051 describe demo.OrderService.GetOrder
# 发起一次调用
grpcurl -plaintext -d '{"id": 1}' localhost:50051 demo.OrderService/GetOrder
# 带 TLS 与自定义头
grpcurl -H 'Authorization: Bearer <token>' \
api.example.com:443 demo.OrderService/GetOrder
# 配合 Kubernetes 端口转发
kubectl port-forward svc/order-api 50051:50051 &
grpcurl -plaintext -d '{"id": 1}' localhost:50051 demo.OrderService/GetOrder
社区与资源
- 源码仓库:https://github.com/fullstorydev/grpcurl
- 官方文档:https://github.com/fullstorydev/grpcurl/blob/master/README.md
- gRPC 官方站点:https://grpc.io/
前往 grpcurl 官网 →
https://github.com/fullstorydev/grpcurl
访问官网 ↗
推荐文章
- 01 GitLab CI/CD 最佳实践:从入门到生产级流水线 07-18
- 02 Prometheus 监控系统搭建:从指标采集到告警通知 07-18
- 03 Ansible 自动化运维实战:从配置管理到应用部署 07-18
- 04 Docker 入门教程:从安装到容器化部署 Web 应用 07-18
- 05 API 集成入门:REST vs GraphQL 对比与选型指南 07-18
- 06 GitHub Actions CI/CD 配置教程:自动化构建、测试与部署 07-18
- 07 Docker Compose 多容器部署:构建完整的应用编排方案 07-18
- 08 Kubernetes 入门部署指南:从零搭建 K8s 集群 07-18
- 09 VS Code 插件推荐 2026:提升开发效率的必备扩展 07-18
- 10 前端开发工具链 2026:Vite / Next.js / Tailwind CSS 生态综述 07-18