# apache/dubbo architecture

> Architecture diagram of the GitHub repository apache/dubbo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/apache/dubbo
- Repository: https://github.com/apache/dubbo

## Overview

Apache Dubbo is a Java RPC and web framework for building microservices. A typical consumer invokes a service through an RPC protocol; provider instances are discovered from registries, and cluster routing and load balancing select traffic targets. The repository also includes provider-side service APIs, metadata, REST/OpenAPI, and observability and security capabilities. The README documents these broad relationships; sampled source is limited, so detailed runtime wiring—especially registry updates and optional integrations—is not asserted here.

Main entry points: [`dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/support/AbstractClusterInvoker.java`](https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/support/AbstractClusterInvoker.java) (Cluster invocation), [`dubbo-rpc/dubbo-rpc-triple/src/main/java/org/apache/dubbo/rpc/protocol/tri/service/TriBuiltinService.java`](https://github.com/apache/dubbo/blob/3.3/dubbo-rpc/dubbo-rpc-triple/src/main/java/org/apache/dubbo/rpc/protocol/tri/service/TriBuiltinService.java) (RPC protocols), [`dubbo-rpc/dubbo-rpc-api/src/main/java/org/apache/dubbo/rpc/ServerService.java`](https://github.com/apache/dubbo/blob/3.3/dubbo-rpc/dubbo-rpc-api/src/main/java/org/apache/dubbo/rpc/ServerService.java) (Service provider), [`dubbo-registry/dubbo-registry-api/src/main/java/org/apache/dubbo/registry/client/ServiceDiscoveryService.java`](https://github.com/apache/dubbo/blob/3.3/dubbo-registry/dubbo-registry-api/src/main/java/org/apache/dubbo/registry/client/ServiceDiscoveryService.java) (Service discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rpc["RPC services"]
  node_serviceapi["Service API<br/>[DubboService.java]"]
  node_rpcprotocol["RPC protocols"]
  node_provider["Service provider<br/>[ServerService.java]"]
end

subgraph group_discovery["Discovery and cluster"]
  node_registry["Service registry"]
  node_discoveryapi["Service discovery"]
  node_clusterinvoke["Cluster invocation"]
  node_directory["Provider directory"]
end

subgraph group_traffic["Traffic management"]
  node_router["Router chain<br/>[RouterChain.java]"]
  node_meshrouter["Mesh routing"]
  node_loadbalance["Load balancing"]
  node_retry["Failure strategies"]
end

subgraph group_capabilities["Platform capabilities"]
  node_metadata["Service metadata"]
  node_metrics["Metrics collection"]
  node_monitoring["Monitoring API"]
  node_security["Access-key storage"]
end

subgraph group_extensions["Web and extensibility"]
  node_openapi["REST OpenAPI"]
  node_mcp["MCP services<br/>[McpSseService.java]"]
end

node_consumer(("RPC consumer"))
node_externalregistry[("Registry service")]

node_consumer -->|"invokes via"| node_rpcprotocol
node_serviceapi -.->|"defines service"| node_provider
node_rpcprotocol -->|"communicates with"| node_provider
node_consumer -->|"discovers instances"| node_discoveryapi
node_discoveryapi -->|"queries"| node_externalregistry
node_registry -.->|"registers services"| node_externalregistry
node_clusterinvoke -.->|"selects providers"| node_directory
node_clusterinvoke -->|"routes traffic"| node_router
node_clusterinvoke -->|"selects target"| node_loadbalance
node_clusterinvoke -.->|"handles failures"| node_retry
node_router -.->|"supports mesh rules"| node_meshrouter
node_metadata -.->|"describes services"| node_provider
node_metrics -.->|"exposes metrics"| node_monitoring
node_consumer -.->|"uses credentials"| node_security
node_rpcprotocol -->|"supports REST APIs"| node_openapi
node_rpcprotocol -.->|"offers MCP services"| node_mcp

click node_serviceapi "https://github.com/apache/dubbo/blob/3.3/dubbo-common/src/main/java/org/apache/dubbo/config/annotation/DubboService.java"
click node_rpcprotocol "https://github.com/apache/dubbo/blob/3.3/dubbo-rpc/dubbo-rpc-triple/src/main/java/org/apache/dubbo/rpc/protocol/tri/service/TriBuiltinService.java"
click node_provider "https://github.com/apache/dubbo/blob/3.3/dubbo-rpc/dubbo-rpc-api/src/main/java/org/apache/dubbo/rpc/ServerService.java"
click node_registry "https://github.com/apache/dubbo/blob/3.3/dubbo-registry/dubbo-registry-api/src/main/java/org/apache/dubbo/registry/RegistryService.java"
click node_discoveryapi "https://github.com/apache/dubbo/blob/3.3/dubbo-registry/dubbo-registry-api/src/main/java/org/apache/dubbo/registry/client/ServiceDiscoveryService.java"
click node_clusterinvoke "https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/support/AbstractClusterInvoker.java"
click node_directory "https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/directory/AbstractDirectory.java"
click node_router "https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/RouterChain.java"
click node_meshrouter "https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/router/mesh/route/MeshRuleRouter.java"
click node_loadbalance "https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/loadbalance/AdaptiveLoadBalance.java"
click node_retry "https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/support/FailoverClusterInvoker.java"
click node_metadata "https://github.com/apache/dubbo/blob/3.3/dubbo-metadata/dubbo-metadata-api/src/main/java/org/apache/dubbo/metadata/MetadataService.java"
click node_metrics "https://github.com/apache/dubbo/blob/3.3/dubbo-metrics/dubbo-metrics-default/src/main/java/org/apache/dubbo/metrics/service/DefaultMetricsService.java"
click node_monitoring "https://github.com/apache/dubbo/blob/3.3/dubbo-metrics/dubbo-metrics-api/src/main/java/org/apache/dubbo/monitor/MonitorService.java"
click node_security "https://github.com/apache/dubbo/blob/3.3/dubbo-plugin/dubbo-auth/src/main/java/org/apache/dubbo/auth/DefaultAccessKeyStorage.java"
click node_openapi "https://github.com/apache/dubbo/blob/3.3/dubbo-plugin/dubbo-rest-openapi/src/main/java/org/apache/dubbo/rpc/protocol/tri/rest/openapi/DefaultOpenAPIService.java"
click node_mcp "https://github.com/apache/dubbo/blob/3.3/dubbo-plugin/dubbo-mcp/src/main/java/org/apache/dubbo/mcp/core/McpSseService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_serviceapi,node_rpcprotocol,node_provider toneBlue
class node_registry,node_discoveryapi,node_clusterinvoke,node_directory,node_externalregistry toneAmber
class node_router,node_meshrouter,node_loadbalance,node_retry toneMint
class node_metadata,node_metrics,node_monitoring,node_security toneRose
class node_openapi,node_mcp,node_consumer toneIndigo
```

## Components

### RPC services

- [Service API](https://github.com/apache/dubbo/blob/3.3/dubbo-common/src/main/java/org/apache/dubbo/config/annotation/DubboService.java): `dubbo-common/src/main/java/org/apache/dubbo/config/annotation/DubboService.java`
- [RPC protocols](https://github.com/apache/dubbo/blob/3.3/dubbo-rpc/dubbo-rpc-triple/src/main/java/org/apache/dubbo/rpc/protocol/tri/service/TriBuiltinService.java): `dubbo-rpc/dubbo-rpc-triple/src/main/java/org/apache/dubbo/rpc/protocol/tri/service/TriBuiltinService.java`
- [Service provider](https://github.com/apache/dubbo/blob/3.3/dubbo-rpc/dubbo-rpc-api/src/main/java/org/apache/dubbo/rpc/ServerService.java): `dubbo-rpc/dubbo-rpc-api/src/main/java/org/apache/dubbo/rpc/ServerService.java`

### Discovery and cluster

- [Service registry](https://github.com/apache/dubbo/blob/3.3/dubbo-registry/dubbo-registry-api/src/main/java/org/apache/dubbo/registry/RegistryService.java): `dubbo-registry/dubbo-registry-api/src/main/java/org/apache/dubbo/registry/RegistryService.java`
- [Service discovery](https://github.com/apache/dubbo/blob/3.3/dubbo-registry/dubbo-registry-api/src/main/java/org/apache/dubbo/registry/client/ServiceDiscoveryService.java): `dubbo-registry/dubbo-registry-api/src/main/java/org/apache/dubbo/registry/client/ServiceDiscoveryService.java`
- [Cluster invocation](https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/support/AbstractClusterInvoker.java): `dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/support/AbstractClusterInvoker.java`
- [Provider directory](https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/directory/AbstractDirectory.java): `dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/directory/AbstractDirectory.java`

### Traffic management

- [Router chain](https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/RouterChain.java): `dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/RouterChain.java`
- [Mesh routing](https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/router/mesh/route/MeshRuleRouter.java): `dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/router/mesh/route/MeshRuleRouter.java`
- [Load balancing](https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/loadbalance/AdaptiveLoadBalance.java): `dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/loadbalance/AdaptiveLoadBalance.java`
- [Failure strategies](https://github.com/apache/dubbo/blob/3.3/dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/support/FailoverClusterInvoker.java): `dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/support/FailoverClusterInvoker.java`

### Platform capabilities

- [Service metadata](https://github.com/apache/dubbo/blob/3.3/dubbo-metadata/dubbo-metadata-api/src/main/java/org/apache/dubbo/metadata/MetadataService.java): `dubbo-metadata/dubbo-metadata-api/src/main/java/org/apache/dubbo/metadata/MetadataService.java`
- [Metrics collection](https://github.com/apache/dubbo/blob/3.3/dubbo-metrics/dubbo-metrics-default/src/main/java/org/apache/dubbo/metrics/service/DefaultMetricsService.java): `dubbo-metrics/dubbo-metrics-default/src/main/java/org/apache/dubbo/metrics/service/DefaultMetricsService.java`
- [Monitoring API](https://github.com/apache/dubbo/blob/3.3/dubbo-metrics/dubbo-metrics-api/src/main/java/org/apache/dubbo/monitor/MonitorService.java): `dubbo-metrics/dubbo-metrics-api/src/main/java/org/apache/dubbo/monitor/MonitorService.java`
- [Access-key storage](https://github.com/apache/dubbo/blob/3.3/dubbo-plugin/dubbo-auth/src/main/java/org/apache/dubbo/auth/DefaultAccessKeyStorage.java): `dubbo-plugin/dubbo-auth/src/main/java/org/apache/dubbo/auth/DefaultAccessKeyStorage.java`

### Web and extensibility

- [REST OpenAPI](https://github.com/apache/dubbo/blob/3.3/dubbo-plugin/dubbo-rest-openapi/src/main/java/org/apache/dubbo/rpc/protocol/tri/rest/openapi/DefaultOpenAPIService.java): `dubbo-plugin/dubbo-rest-openapi/src/main/java/org/apache/dubbo/rpc/protocol/tri/rest/openapi/DefaultOpenAPIService.java`
- [MCP services](https://github.com/apache/dubbo/blob/3.3/dubbo-plugin/dubbo-mcp/src/main/java/org/apache/dubbo/mcp/core/McpSseService.java): `dubbo-plugin/dubbo-mcp/src/main/java/org/apache/dubbo/mcp/core/McpSseService.java`

### Other components

- **RPC consumer**
- **Registry service**

## Connections

- RPC consumer → RPC protocols: invokes via
- Service API → Service provider: defines service
- RPC protocols → Service provider: communicates with
- RPC consumer → Service discovery: discovers instances
- Service discovery → Registry service: queries
- Service registry → Registry service: registers services
- Cluster invocation → Provider directory: selects providers
- Cluster invocation → Router chain: routes traffic
- Cluster invocation → Load balancing: selects target
- Cluster invocation → Failure strategies: handles failures
- Router chain → Mesh routing: supports mesh rules
- Service metadata → Service provider: describes services
- Metrics collection → Monitoring API: exposes metrics
- RPC consumer → Access-key storage: uses credentials
- RPC protocols → REST OpenAPI: supports REST APIs
- RPC protocols → MCP services: offers MCP services
