-1
日增长
4,980
stars
1,049
forks
145
watchers
2,601
prs
1,134
issues
48
releases
README
Apache Dubbo for Golang
!license
---
English | 中文
Apache Dubbo-go 是一款高性能、功能丰富的微服务框架。作为 Apache Dubbo 生态的 Go 语言实现,它充分利用 Golang 的并发特性,助力开发者在云原生时代构建扩展性强、可靠性高的分布式应用。
在全新的 v3.3.x 系列版本中,Dubbo-go 已从传统的 RPC 框架演进为云原生智能微服务治理平台,引入了深度的 AI 集成与 Proxyless Mesh(无代理网格)能力。
您可以访问 官网 以获取更多信息。
近期更新
详细变更请参阅 CHANGELOG.md。
- 3.3.2:
升级提醒: 需要 Go 1.25 或更高版本。旧版 config 包已被移除;直接导入该包的应用需要迁移到实例/选项 API 和 global 包下的配置类型。迁移说明和当前用法请参阅 3.3.2 更新日志及 dubbo-go-samples。
Apache Dubbo-go 3.3.2 重点提升生产可用性,涵盖 API 整合、Triple 协议能力、应用级元数据、服务治理、并发安全和发布工具链。该版本扩展了泛化调用和面向 HTTP 的 Triple 能力,更新了项目生成流程,并修复了多项竞态、过期快照和资源泄漏问题。
- 3.3.1:优化配置热加载,通过基于内容的缓存避免重复通知;新增实验性 HTTP/3 支持、Apollo 集成和 Triple 协议 OpenAPI 生成;修复高并发服务发现中的关键竞态问题。
- 3.3.0:引入脚本路由、多目标条件路由、Triple 协议 keepalive 与连接池、Nacos 多类别订阅,并增强可观测性和互操作性。
快速开始
环境准备
Go 1.25 或更高版本。
安装
使用以下命令安装 Dubbo-go:
bash
go get dubbo.apache.org/dubbo-go/v3@latest
快速示例
通过我们的 快速开始 (Helloworld) 示例,您可以在 5 分钟内掌握如何开发一个 RPC 应用。
过程如下方代码所示,非常简单:您使用 Protobuf 定义一个服务,提供您自己的服务实现,将其注册到服务器,然后启动服务器。
go
func (srv GreetTripleServer) Greet(ctx context.Context, req greet.GreetRequest) (greet.GreetResponse, error) {
resp := &greet.GreetResponse{Greeting: req.Name}
return resp, nil
}
func main() {
srv, _ := server.NewServer(
server.WithServerProtocol(
protocol.WithPort(20000),
protocol.WithTriple(),
),
)
_ := greet.RegisterGreetServiceHandler(srv, &GreetTripleServer{})
if err := srv.Serve(); err != nil {
logger.Error(err)
}
}
服务器启动并运行后,您可以通过 cURL 调用您的服务:
shell
curl \
--header "Content-Type: application/json" \
--data '{"name": "Dubbo"}' \
http://localhost:20000/greet.GreetService/Greet
或者,您也可以启动一个标准的 dubbo-go 客户端来调用该服务:
go
func main() {
cli, _ := client.NewClient(
client.WithClientURL("127.0.0.1:20000"),
)
svc, _ := greet.NewGreetService(cli)
resp, _ := svc.Greet(context.Background(), &greet.GreetRequest{Name: "hello world"})
logger.Infof("Greet response: %s", resp.Greeting)
}
有关详细用法,请参阅示例。接下来,请访问官网,了解如何部署、监控和管理您的 dubbo-go 应用的流量。
功能特性
!dubbo-go-architecture
RPC 协议: Triple (兼容 gRPC 且对 HTTP 友好)、Dubbo、JSONRPC、HTTP/2、HTTP/3 (实验性)。
服务发现: Nacos、Zookeeper、Etcd、Polaris-mesh。
负载均衡: 自适应、随机、轮询、最少活跃调用、一致性哈希。
流量管理: 流量切分、超时设置、速率限制、金丝雀发布。
配置管理: YAML 文件、动态配置(Nacos、Apollo、Zookeeper 等),支持基于指纹去重的优化版文件监听。
可观测性: 指标(Prometheus)、追踪(OpenTelemetry v1.21.0+ 标准化 Span 名)、日志(完整的生命周期事件记录)。
高可用策略: 故障转移 (Failover)、快速失败 (Failfast)、失败安全/失败自动恢复 (Failsafe/Failback)、广播 (Broadcast)、并行调用 (Forking)。
跨语言互通: 通过 Triple 协议泛化调用、版本通配符匹配等技术,实现与 Java 版 Dubbo 的完美互通。
工具
常用开发工具位于 tools/ 目录。
| 工具 | 用途 |
| --- | --- |
| dubbogo-cli | 创建 demo/应用脚手架、安装配套工具、查看元数据并调试服务。 |
| protoc-gen-go-triple | 从 protobuf 服务定义生成 dubbo-go Triple 绑定代码。 |
| protoc-gen-triple-openapi | 从 Triple protobuf 服务生成 OpenAPI v3 文档。 |
| imports-formatter | 按 dubbo-go 分组规则整理 Go import 块。 |
| dubbo-go-schema | 为 dubbo-go YAML 配置提供 JSON Schema 补全与校验。 |
| benchmark | 对比 Dubbo-Go、Dubbo-Java 和 gRPC 框架性能的基准测试套件。 |
生Top issues
#2Who's Using Dubbo-go? 谁在使用 Dubbo-go?80 comments · 2018-09-03#2410Dubbo-go作为Provider时, RPC返回的结构体中如果包含指针字段, Java端无法正确解析13 comments · 2023-09-01#3338[FEATURE] Enhance OpenTelemetry tracing diagnostics / 增强 OpenTelemetry Trace 诊断能力12 comments · 2026-05-20#2151nacos 配置中心加载配置启动 dubbo 报 error11 comments · 2022-12-08#3276[提案] 使 dubbo-go 对 AI 编程工具更加友好8 comments · 2026-03-22#3614[Bug] go test -race exposes 10 data races (8 packages)7 comments · 2026-08-07#3337[FEATURE] Improve Metrics coverage and standardization / 提升 Metrics 覆盖度与标准化7 comments · 2026-05-20#2158如何在client过滤器中获取http header6 comments · 2022-12-13
Discussions
#3766Dubbo-Go 可观测字段梳理1 comments · 2026-10-15#37192026-09-05 weekly0 comments · 2026-09-05#3673[OSPP 2026] Triple 协议性能分析与优化15 comments · 2026-08-17#35342026-07-26 weekly0 comments · 2026-07-26#3454[提案] AI 时代 apache/dubbo-go 的演进方向:聚焦 AI-ready 基础设施,而非另一个 AI 框架0 comments · 2026-06-25#33742026-06-07 Weekly0 comments · 2026-06-07#3342Dubbo-go Metadata Design Spec — 综合审查报告3 comments · 2026-05-24#3318nacos-go-sdk 从 v2 升级到 v31 comments · 2026-05-06
Latest release
tools/dubbogo-cli/v1.0.1 tools/dubbogo-cli/v1.0.1 2026-08-05dubbogo-cli v1.0.1 Command-line helper for scaffolding projects and managing the Apache dubbo-go toolchain. What's Changed fix: restore generated-project go.sum files by @AlexStocks in https://github.com/apache/dubbo-go/pull/3589 fix: update dubbogo CLI templates for Dubbo-Go 3.3 by @AlexStocks in https://github.com/apache/dubbo-go/pull/3587 update tools and companion-tool integration by @Alanxtl in https://github.com/apache/dubbo-go/pull/3585 chore: modernize CLI code style by @Alanxtl in https://github.com/apache/dubbo-go/pull/3471 fix: generate dependency locks for CLI scaffolds by