apache /dubbo-go

Go Implementation For Apache Dubbo .

★ 4,980⑂ 1,049👁 145⑃ 2,601● 1,134▤ 48
GoApache-2.0Created 2018-08-08dubbo.apache.org/
下载:tools/dubbogo-cli/v1.0.1tools/dubbogo-cli/v1.0.1 ↓1.0.12026-08-05
-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

Discussions

Latest release

tools/dubbogo-cli/v1.0.1 tools/dubbogo-cli/v1.0.1 2026-08-05
dubbogo-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 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON