-1
Daily
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 is a high-performance RPC and microservice framework compatible with other Dubbo language implementations. It leverages Golang's concurrency features to provide efficient service governance, including service discovery, load balancing, and traffic management. Dubbo-go supports multiple protocols, such as Dubbo, JSONRPC, Triple(gRPC-compatible), gRPC, HTTP, HTTP2, and HTTP/3 (experimental), ensuring seamless integration in heterogeneous environments.
You can visit the official website for more information.
Recent Updates
For detailed changes, refer to CHANGELOG.md.
- 3.3.2:
Upgrade note: Go 1.25 or later is required. The legacy config package has been removed; applications that imported it directly must migrate to the instance/options APIs and configuration types under global. See the 3.3.2 changelog and dubbo-go-samples for migration details and current usage.
Apache Dubbo-go 3.3.2 is a production-readiness release focused on API consolidation, Triple protocol capabilities, application-level metadata, service governance, concurrency safety, and release tooling. It completes the removal of the legacy config package, expands generic invocation and HTTP-facing Triple features, refreshes generated-project workflows, and fixes multiple races, stale-snapshot issues, and resource leaks.
- 3.3.1: Optimized configuration hot-reloading with content-based caching to prevent redundant notifications. Added experimental HTTP/3 support, Apollo integration, and Triple protocol OpenAPI generation. Fixed critical race conditions in service discovery under high-concurrency.
- 3.3.0: Introduced script routing, multi-destination conditional routing, Triple protocol keepalive and connection pooling, Nacos multi-category subscriptions, and enhancements for observability and interoperability.
Getting started
Prerequisites
- Go 1.25 or later.
Installation
To install Dubbo-go, use the following command:
Bash
go get dubbo.apache.org/dubbo-go/v3@latest
Quick Example
You can learn how to develop a dubbo-go RPC application step by step in 5 minutes by following our Quick Start demo.
It's as simple as the code shown below, you define a service with Protobuf, provide your own service implementation, register it to a server, and start the server.
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)
}
}
After the server is up and running, call your service via cURL:
shell
curl \
--header "Content-Type: application/json" \
--data '{"name": "Dubbo"}' \
http://localhost:20000/greeTop 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