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.
For detailed changes, refer to CHANGELOG.md.
-
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.
- Go 1.24 or later (recommended for compatibility with recent updates).
To install Dubbo-go, use the following command:
go get dubbo.apache.org/dubbo-go/v3@latestYou 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.
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:
curl \
--header "Content-Type: application/json" \
--data '{"name": "Dubbo"}' \
http://localhost:20000/greet.GreetService/GreetOr, you can start a standard dubbo-go client to call the service:
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)
}See the samples for detailed information on usage. Next, learn how to deploy, monitor and manage the traffic of your dubbo-go application by visiting the official website.
Dubbo-go provides robust service governance capabilities:
- RPC Protocols: Triple, gRPC compatible and HTTP-friendly
- Service Discovery: Nacos, Zookeeper, Etcd, Polaris-mesh.
- Load Balance: Adaptive, Random, RoundRobin, LeastActive, ConsistentHash
- Traffic Management: traffic split, timeout, rate limiting, canary release
- Configuration: yaml file, dynamic configuration(Nacos, Apollo, Zookeeper, etc.).
- Observability: Metrics (Prometheus), tracing (OpenTelemetry v1.21.0+ with insecure options and standardized span names), logging (with service registration lifecycle events).
- HA Strategy: Failover, Failfast, Failsafe/Failback, Available, Broadcast, Forking.
- Interoperability: Full compatibility with Apache Dubbo (Java) via Triple protocol generic calls, group/version wildcard matching, and TLS API redesign.
The tools/ directory and the dubbogo/tools repository provide several utilities to streamline your Dubbo-Go development experience.
A tool that provides JSON Schema for Dubbo-Go configuration files, enabling editor assistance such as completion, hints, and validation.
For usage details, see the dubbo-go-schema README.
A command-line tool for bootstrapping, managing, and debugging Dubbo-Go applications.
A protoc plugin that generates Go client and server code for the Triple protocol from .proto definition files.
Note: This tool replaces the deprecated protoc-gen-dubbo3grpc and deprecated protoc-gen-go-triple.
For usage details, see the protoc-gen-go-triple README.
A formatting tool for Dubbo-Go developers that organizes Go import blocks according to the community style guide.
For usage details, see the imports-formatter README.
- dubbo-go-samples
- dubbo-go-pixiu which acting as a proxy to solve Dubbo multi-language interoperability
- Interoperability with Dubbo Java
- Protoc-gen-go-triple
- Console, under development
- dubbo-go-extensions, under development
- Official Website: https://dubbo.apache.org/
- Dubbo-go Documentation: https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/
- CHANGELOG: https://github.com/apache/dubbo-go/blob/main/CHANGELOG.md
- GitHub Issues: https://github.com/apache/dubbo-go/issues
- Mailing Lists: https://dubbo.apache.org/en/community/
Contributions, issues, and discussions are welcome. Please visit CONTRIBUTING for details on submitting patches and the contribution workflow.
Join our discussion group through Ding talk or WeChat.
If you are using apache/dubbo-go and think that it helps you or want to contribute code for Dubbo-go, please add your company to the user list to let us know your needs.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Apache Dubbo-go software is licensed under the Apache License Version 2.0. See the LICENSE file for details.
