by smallnest

smallnest / rpcx

A zero cost, faster multi-language bidirectional microservices framework in Go, like alibaba Dubbo,...

5.1K Stars 829 Forks Last release: Not found Other 521 Commits 32 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Official site: http://rpcx.io

License GoDoc travis Go Report Card coveralls QQ2群 QQ群(已满)

Notice: etcd/grpc problem

still has some problems if you use go module, please add the below line in your go.mod:
replace google.golang.org/grpc => google.golang.org/grpc v1.29.0
Will remove etcd plugin into an indenpendent project in future.

一直不是很好的支持go module方式,尤其是和grpc的版本兼容问题,至少目前的rpcx可以通过在你的go.mod中加入以上一行上面解决依赖问题。


A tcpdump-like tool added: rpcxdump。 You can use it to debug communications between rpcx services and clients.


you can use other programming languages besides Go to access rpcx services.

  • rpcx-gateway: You can write clients in any programming languages to call rpcx services via rpcx-gateway
  • http invoke: you can use the same http requests to access rpcx gateway
  • Java Services/Clients: You can use rpcx-java to implement/access rpcx servies via raw protocol.

If you can write Go methods, you can also write rpc services. It is so easy to write rpc applications with rpcx.


install the basic features:

go get -v github.com/smallnest/rpcx/...

If you want to use

registry, use those tags to
go get
go build
go run
. For example, if you want to use all features, you can:
go get -v -tags "quic kcp ping utp" github.com/smallnest/rpcx/...

tags: - quic: support quic transport - kcp: support kcp transport - ping: support network quality load balancing - utp: support utp transport


rpcx is a RPC framework like Alibaba Dubbo and Weibo Motan.

rpcx 3.0 has been refactored for targets: 1. Simple: easy to learn, easy to develop, easy to intergate and easy to deploy 2. Performance: high perforamnce (>= grpc-go) 3. Cross-platform: support raw slice of bytes, JSON, Protobuf and MessagePack. Theoretically it can be used with java, php, python, c/c++, node.js, c# and other platforms 4. Service discovery and service governance: support zookeeper, etcd and consul.

It contains below features - Support raw Go functions. There's no need to define proto files. - Pluggable. Features can be extended such as service discovery, tracing. - Support TCP, HTTP, QUIC and KCP - Support multiple codecs such as JSON, Protobuf, MessagePack and raw bytes. - Service discovery. Support peer2peer, configured peers, zookeeper, etcd, consul and mDNS. - Fault tolerance:Failover, Failfast, Failtry. - Load banlancing:support Random, RoundRobin, Consistent hashing, Weighted, network quality and Geography. - Support Compression. - Support passing metadata. - Support Authorization. - Support heartbeat and one-way request. - Other features: metrics, log, timeout, alias, circuit breaker. - Support bidirectional communication. - Support access via HTTP so you can write clients in any programming languages. - Support API gateway. - Support backup request, forking and broadcast.

rpcx uses a binary protocol and platform-independent, which means you can develop services in other languages such as Java, python, nodejs, and you can use other prorgramming languages to invoke services developed in Go.

There is a UI manager: rpcx-ui.


Test results show rpcx has better performance than other rpc framework except standard rpc lib.

The benchmark code is at rpcx-benchmark.

Listen to others, but test by yourself.

Test Environment

  • CPU: Intel(R) Xeon(R) CPU E5-2630 v3 @ 2.40GHz, 32 cores
  • Memory: 32G
  • Go: 1.9.0
  • OS: CentOS 7 / 3.10.0-229.el7.x86_64

Use - protobuf - the client and the server on the same server - 581 bytes payload - 500/2000/5000 concurrent clients - mock processing time: 0ms, 10ms and 30ms

Test Result

mock 0ms process time

Throughputs Mean Latency P99 Latency

mock 10ms process time

Throughputs Mean Latency P99 Latency

mock 30ms process time

Throughputs Mean Latency P99 Latency


You can find all examples at rpcxio/rpcx-examples.

The below is a simple example.


    // define example.Arith

s := server.NewServer()
s.RegisterName("Arith", new(example.Arith), "")
s.Serve("tcp", addr)


    // prepare requests

d := client.NewPeer2PeerDiscovery("[email protected]"+addr, "")
xclient := client.NewXClient("Arith", client.Failtry, client.RandomSelect, d, client.DefaultOption)
defer xclient.Close()
err := xclient.Call(context.Background(), "Mul", args, reply, nil)


see contributors.

Welcome to contribute: - submit issues or requirements - send PRs - write projects to use rpcx - write tutorials or articles to introduce rpcx


Apache License, Version 2.0

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.