Clone this repo:
  1. c952cd4 add compatible (#5167) by Haiyang · 44 minutes ago master
  2. b5e9f9d exclude .github folder for rat-plugin (#5165) by Huang YunKun · 3 days ago
  3. 423facb enable github action for basic ci check by Huang YunKun · 3 days ago
  4. 055f1cc [Dubbo-4871] fix cache file name issue in windows platform (#5158) by Joe · 4 days ago
  5. 1a58ca0 followup of c31ef9ad934688469826b39f35b709f712e56c75, use readObject(json, Object.class) by ken.lj · 5 days ago

Apache Dubbo Project

Build Status codecov maven license Average time to resolve an issue Percentage of issues still open Tweet Gitter

Apache Dubbo is a high-performance, Java based open source RPC framework. Please visit official site for quick start and documentations, as well as Wiki for news, FAQ, and release notes.

We are now collecting dubbo user info in order to help us to improve Dubbo better, pls. kindly help us by providing yours on issue#1012: Wanted: who's using dubbo, thanks :)




  • Transparent interface based RPC
  • Intelligent load balancing
  • Automatic service registration and discovery
  • High extensibility
  • Runtime traffic routing
  • Visualized service governance

Getting started

The following code snippet comes from Dubbo Samples. You may clone the sample project and step into dubbo-samples-api sub directory before read on.

# git clone
# cd dubbo-samples/dubbo-samples-api

There's a README file under dubbo-samples-api directory. Read it and try this sample out by following the instructions.

Maven dependency


Define service interfaces

package org.apache.dubbo.samples.api;

public interface GreetingService {
    String sayHi(String name);

See api/ on GitHub.

Implement service interface for the provider

package org.apache.dubbo.samples.provider;

import org.apache.dubbo.samples.api.GreetingsService;

public class GreetingsServiceImpl implements GreetingsService {
    public String sayHi(String name) {
        return "hi, " + name;

See provider/ on GitHub.

Start service provider

package org.apache.dubbo.samples.provider;

import org.apache.dubbo.config.ApplicationConfig;
import org.apache.dubbo.config.RegistryConfig;
import org.apache.dubbo.config.ServiceConfig;
import org.apache.dubbo.samples.api.GreetingsService;

import java.util.concurrent.CountDownLatch;

public class Application {
    private static String zookeeperHost = System.getProperty("zookeeper.address", "");

    public static void main(String[] args) throws Exception {
        ServiceConfig<GreetingsService> service = new ServiceConfig<>();
        service.setApplication(new ApplicationConfig("first-dubbo-provider"));
        service.setRegistry(new RegistryConfig("zookeeper://" + zookeeperHost + ":2181"));
        service.setRef(new GreetingsServiceImpl());

        System.out.println("dubbo service started");
        new CountDownLatch(1).await();

See provider/ on GitHub.

Build and run the provider

# mvn clean package
# mvn -Dexec.mainClass=org.apache.dubbo.samples.provider.Application exec:java

Call remote service in consumer

package org.apache.dubbo.samples.client;

import org.apache.dubbo.config.ApplicationConfig;
import org.apache.dubbo.config.ReferenceConfig;
import org.apache.dubbo.config.RegistryConfig;
import org.apache.dubbo.samples.api.GreetingsService;

public class Application {
    private static String zookeeperHost = System.getProperty("zookeeper.address", "");

    public static void main(String[] args) {
        ReferenceConfig<GreetingsService> reference = new ReferenceConfig<>();
        reference.setApplication(new ApplicationConfig("first-dubbo-consumer"));
        reference.setRegistry(new RegistryConfig("zookeeper://" + zookeeperHost + ":2181"));
        GreetingsService service = reference.get();
        String message = service.sayHi("dubbo");

See consumer/ on GitHub.

Build and run the consumer

# mvn clean package
# mvn -Dexec.mainClass=org.apache.dubbo.samples.client.Application exec:java

The consumer will print out hi, dubbo on the screen.

Next steps


If you want to try out the cutting-edge features, you can build with the following commands. (Java 1.8 is required to build the master branch)

  mvn clean install



See CONTRIBUTING for details on submitting patches and the contribution workflow.

How can I contribute?

  • Take a look at issues with tag called Good first issue or Help wanted.
  • Join the discussion on mailing list, subscription guide.
  • Answer questions on issues.
  • Fix bugs reported on issues, and send us pull request.
  • Review the existing pull request.
  • Improve the website, typically we need
    • blog post
    • translation on documentation
    • use cases about how Dubbo is being used in enterprise system.
  • Improve the dubbo-admin/dubbo-monitor.
  • Contribute to the projects listed in ecosystem.
  • Any form of contribution that is not mentioned above.
  • If you would like to contribute, please send an email to to let us know!

Reporting bugs

Please follow the template for reporting any issues.

Reporting a security vulnerability

Please report security vulnerability to us privately.

Dubbo ecosystem



Apache Dubbo is under the Apache 2.0 license. See the LICENSE file for details.