dubbo README

The project's README from github.com/apache/dubbo. As one markdown file: README.md.

Apache Dubbo Project

Build and Test For PR Codecov Maven License Average time to resolve an issue Percentage of issues still open

Apache Dubbo is a powerful and user-friendly Web and RPC framework. It supports multiple language implementations such as Java, Go, Python, PHP, Erlang, Rust, and Node.js/Web.

Dubbo provides solutions for communication, service discovery, traffic management, observability, security, tooling, and best practices for building enterprise-grade microservices.

🚀 We're collecting user info to improve Dubbo. Help us out here: Who's using Dubbo


🧱 Architecture

Architecture


🚀 Getting Started

📦 Lightweight RPC API

Start quickly with our 5-minute guide

Dubbo allows you to build RPC services using a minimal codebase and a lightweight SDK. It supports protocols like:

🌱 Microservices with Spring Boot

Kickstart your project using Spring Boot Starter.

Using just a dependency and a YAML config, you can unlock the full power of Dubbo: service discovery, observability, tracing, etc.

➡️ Learn how to deploy, monitor, and manage traffic for Dubbo services.


🛠️ More Features

Explore more through our hands-on tasks:


📦 Which Dubbo Version Should I Use?

Dubbo3

📦 Version Compatibility

Version JDK Support Dependencies Highlights
3.3.7-SNAPSHOT 1.8 – 25 Coming Soon ✅ JDK 25 Support
3.3.6 1.8 – 21 View Dependencies ✅ Mutiny Reactive Support
✅ Affinity Router
✅ Method-level TPS Limiting
✅ Spring 6 Security Plugin
✅ Enhanced Environment Variable Config
3.3.5 1.8 – 21 View Dependencies ✅ Actively Maintained
✅ Triple Protocol (gRPC/cURL)
✅ REST Support
✅ Spring Boot Starters
3.2.16 1.8 – 17 View Dependencies ✅ Actively Maintained
✅ Metrics & Tracing
✅ Thread Pool Isolation
✅ +30% Performance
✅ Native Image Support
3.1.11 1.8 – 17 View Dependencies ⚠️ Stable, but Not Actively Maintained

Dubbo2

Version JDK Dependencies Description
2.7.23 1.8 dependency list ❌ EOL
2.6.x, 2.5.x 1.6 - 1.7 dependency list ❌ EOL

🤝 Contributing

See our CONTRIBUTING guide to get started!

🔁 Community Collaboration

💡 How You Can Help

If you're interested in contributing, email us at [email protected].


🐞 Reporting Issues

Please use our issue template when reporting bugs.


🔐 Reporting Security Vulnerabilities

Please report vulnerabilities privately to [email protected].


📬 Contact


📄 License

Apache Dubbo is licensed under the Apache License 2.0.

dubbo (apache/dubbo)

service-mesh
Searching Database…

41.6K ·GitHub
What is this?Apache Dubbo is an RPC and microservices framework — this repository is its Java implementation. It covers communication, service discovery, traffic management, observability, security, and tooling for building enterprise-grade microservices.
Is this just a Java library, or a bigger framework?It is a full Web and RPC framework rather than a small library — and Java is not the only flavor: Dubbo also ships for Go, Python, PHP, Erlang, Rust, and Node.js/Web. This repo holds the Java one.
How do I get a first service running?Two routes: a lightweight RPC API with a minimal codebase (there is a 5-minute guide), or the Spring Boot Starter — one dependency plus a YAML config unlock service discovery, observability, and tracing.
Which JDK version do I need?It depends on the Dubbo line: 3.3.6 supports JDK 1.8-21 (3.3.7 snapshots add JDK 25), while 3.2.16 tops out at JDK 17, and legacy 2.6.x/2.5.x ran on JDK 1.6-1.7.
Is the old Dubbo2 line still safe to start a new project on?No — Dubbo2 releases (2.7.23 and older 2.6.x/2.5.x) are end-of-life, and even 3.1.11 is stable but no longer actively maintained. Pick 3.3.x or 3.2.x for active support.
What protocols can my services talk over?Triple (gRPC-compatible and testable with cURL), the classic Dubbo2 protocol over TCP, REST, or a custom protocol of your own.
How do services find each other at runtime?Consumers dynamically discover provider instances through a registry such as Zookeeper or Nacos, and traffic between them follows strategies you define.
Does it integrate with Kubernetes and service meshes?Yes — Kubernetes and service mesh support is one of the documented hands-on areas, alongside traffic management, observability, extensibility, and security.
Is there an admin console for managing services?Yes — Dubbo ships built-in support for a visualized console alongside dynamic config, metrics, tracing, and security.
Creator
apache
Size
60.3 MB
Stars
41.6K
Age
14y
Commits · 90 Days