# grpc-tools gRPC 流量调试工具集

> Bradley Kemp 编写的一套 gRPC 调试工具，自称相当于 gRPC 版的 Fiddler 或 Charles。grpc-dump 作为本地 HTTP(S) 代理运行，把应用发出的每次 gRPC 与 gRPC-Web 调用记录为 JSON 流，包含服务名、方法名、元数据、可能出现的错误状态，以及每条消息的原始与解析形式；没有 .proto 文件时，它会以启发式方法解码消息。grpc-replay 重新发送记录下的请求并核对服务器响应，grpc-fixture 用保存的转储应答客户端，它们都构建在 grpc-proxy Go 库之上。

- 类型：工具
- 目标：应用 · 协议
- 类别：协议分析工具
- 关联：基础工具
- 来源复核于：2026-10-27
- 收录于：2026-11-04
- 原始资源：<https://github.com/bradleyjkemp/grpc-tools>
- 一手来源：<https://github.com/bradleyjkemp/grpc-tools/blob/928b1b952d0d1345f0ef8fd2702e2df5240068bd/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/grpc-tools/>
- 记录 JSON：<https://awesomerea.org/resources/grpc-tools/record.json>
- 英文版：[English](https://awesomerea.org/resources/grpc-tools/index.md)

## 使用条件与局限

- 审阅对象为 master 分支提交 928b1b9（2023-11-14），也是最后一次推送。最新发行版为 v0.2.6（2020-06-30），master 在其后另有六个提交，主要是依赖升级，另将消息大小上限提高到 64 MB。README 称这些工具仍处于 alpha 阶段，并提醒各版本之间可能有不兼容的改动。
- 可通过作者的 Homebrew tap、发行版压缩包（Linux、macOS 和 Windows 的 amd64 构建）或 go install 安装；go.mod 声明 Go 1.13，并要求 grpc-go v1.26.0、golang/protobuf v1.4.2 和 protoreflect v1.7.0。被测应用需要指向该代理；README 提醒，连接 localhost 的客户端通常会忽略代理设置。system_proxy 选项的说明针对 macOS。
- 要求 TLS 的客户端需要信任为被拦截域名准备的证书；README 推荐用 mkcert 生成证书，并安装在用户自己的机器上。提供 .proto 根目录或描述符后可以精确解码，而不必依赖启发式解码。集成测试使用一个小型 test.proto 以及项目自己录制的转储和 fixture 文件；仓库附带 CircleCI 配置。
- 采用 MIT 许可证。转储包含完整的消息内容和元数据，其中也包括请求头里的凭据，因此应作为敏感数据处理。

## 一手来源

1. <https://github.com/bradleyjkemp/grpc-tools/blob/928b1b952d0d1345f0ef8fd2702e2df5240068bd/README.md>
2. <https://github.com/bradleyjkemp/grpc-tools/blob/928b1b952d0d1345f0ef8fd2702e2df5240068bd/grpc-dump/README.md>
3. <https://github.com/bradleyjkemp/grpc-tools/blob/928b1b952d0d1345f0ef8fd2702e2df5240068bd/grpc-proxy/README.md>
4. <https://github.com/bradleyjkemp/grpc-tools/blob/928b1b952d0d1345f0ef8fd2702e2df5240068bd/grpc-replay/README.md>
5. <https://github.com/bradleyjkemp/grpc-tools/blob/928b1b952d0d1345f0ef8fd2702e2df5240068bd/grpc-fixture/README.md>
6. <https://github.com/bradleyjkemp/grpc-tools/blob/928b1b952d0d1345f0ef8fd2702e2df5240068bd/CHANGELOG.md>
7. <https://github.com/bradleyjkemp/grpc-tools/blob/928b1b952d0d1345f0ef8fd2702e2df5240068bd/go.mod>
8. <https://github.com/bradleyjkemp/grpc-tools/blob/928b1b952d0d1345f0ef8fd2702e2df5240068bd/.goreleaser.yml>
9. <https://github.com/bradleyjkemp/grpc-tools/blob/928b1b952d0d1345f0ef8fd2702e2df5240068bd/LICENSE>
10. <https://github.com/bradleyjkemp/grpc-tools/tree/928b1b952d0d1345f0ef8fd2702e2df5240068bd/integration_test>
11. <https://github.com/bradleyjkemp/grpc-tools/releases/tag/v0.2.6>

## 同分区更多条目：协议

- [Holley EFI Parser 日志与 CAN 协议解析工具](https://awesomerea.org/zh/resources/holley-efi-parser/index.md) · 工具
- [CAN Bus Parser VanMoof 总线解析工具](https://awesomerea.org/zh/resources/vanmoof-can-bus-parser/index.md) · 工具
- [Lutron Protocols 路创通信协议研究](https://awesomerea.org/zh/resources/lutron-protocols/index.md) · 项目
- [Hermes Flipper Zero UART 波特率检测与控制台工具](https://awesomerea.org/zh/resources/hermes-flipperzero/index.md) · 工具
- [RoflLens《英雄联盟》回放协议分析工具](https://awesomerea.org/zh/resources/rofllens/index.md) · 工具
- [LogicAnalyzer 逻辑分析仪](https://awesomerea.org/zh/resources/logicanalyzer/index.md) · 工具

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。