readme-cn.md

English | 简体中文

使用前说明

这是grpc常用的知识点示例，非常适合全面深入学习和使用grpc，这些grpc知识点是从go开发框架 sponge 提取出来的。

sponge 是一个集成了自动生成代码、gin和grpc框架的强大的开发框架。从生成代码、开发、测试、api文档到部署一站式项目开发，大幅提高了开发效率和降低了开发难度，实现"低代码方式"进行开发项目。

github 地址: https://github.com/zhufuyi/sponge

快速开始

Go设置

如果已经设置过go可以跳过此步骤。

# Linux 或 MacOS
export GOROOT="/opt/go"     # 你的go安装目录
export GOPATH=$HOME/go      # 设置 go get 命令下载第三方包的目录
export GOBIN=$GOPATH/bin    # 设置 go install 命令编译后生成可执行二进制文件的存放目录
export PATH=$PATH:$GOBIN:$GOROOT/bin   # 把$GOBIN目录添加到系统path


# Windows
setx GOPATH "D:\你的目录"     # 设置 go get 命令下载第三方包的目录
setx GOBIN "D:\你的目录\bin"   # 设置 go install 命令编译后生成可执行二进制文件的存放目录

安装protoc和插件

1. 复制目录 include 到 $GOBIN.

2. 下载protoc地址: https://github.com/protocolbuffers/protobuf/releases/tag/v25.2

根据系统类型下载对应的protoc二进制文件，并把二进制文件移动到 $GOBIN.

3. 安装protoc插件

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest
go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest
go install github.com/envoyproxy/protoc-gen-validate@latest
go install github.com/mohuishou/protoc-gen-go-gin@latest
go install github.com/srikrsna/protoc-gen-gotag@latest

所有示例列表

• protobuf 的序列化和反序列化
• protobuf tag
• grpc 四种调用方式
• grpc 拦截器
• grpc 恢复
• grpc 日志
• grpc keepalive
• grpc 元数据传递与读写
• grpc 超时
• grpc 参数校验
• grpc 鉴权
  • TLS 鉴权
  • kv token 鉴权
  • jwt 鉴权
• grpc 注册与发现
  • consul
  • etcd
  • nacos
• grpc 负载均衡
  • ip
  • consul
  • etcd
  • nacos
• grpc 限流
• grpc 熔断
• grpc 重试
• grpc 链路跟踪
  • http --> grpc
  • grpc --> grpc
• grpc 指标
  • 默认 grpc metrics
  • 自定义 grpc metrics
• 在http中调用grpc
  • 在gin中调用grpc
  • grpc 网关
• grpc 封装实践