Codis

<img src="doc/pictures/logo-3.png" height=80></img>

Codis is a proxy based high performance Redis cluster solution written in Go. It is production-ready and widely used at wandoujia.com and many companies. You can see Codis Releases for latest and most stable realeases.

Donation

Donate if you want to help us maintaining this project. Thank you! See this issue for details

Compared with Twemproxy and Redis Cluster

<table> <tr><th></th><th>Codis</th><th>Twemproxy</th><th>Redis Cluster</th></tr> <tr><td>resharding without restarting cluster</td><td>Yes</td><td>No</td><td>Yes</td></tr> <tr><td>pipeline</td><td>Yes</td><td>Yes</td><td>No</td></tr> <tr><td>hash tags for multi-key operations</td><td>Yes</td><td>Yes</td><td>Yes</td></tr> <tr><td>multi-key operations while resharding</td><td>Yes</td><td>-</td><td>No(<a href="http://redis.io/topics/cluster-spec#multiple-keys-operations">details</a>)</td></tr> <tr><td>Redis clients supporting</td><td>Any clients</td><td>Any clients</td><td>Clients have to support cluster protocol</td></tr> </table> "Resharding" means migrating the data in one slot from one redis server to another, usually happens while increasing/decreasing the number of redis servers.

Other Features

• GUI website dashboard & admin tools
• Supports most of Redis commands, Fully compatible with Twemproxy(https://github.com/twitter/twemproxy)
• Proxies can register on zk/etcd, clients can avoid dead proxies, see "High Availability" section.

Tutorial

简体中文 English (WIP)

FAQ

简体中文 English (WIP)

High Availability

简体中文 English (WIP)

Architecture

Snapshots

Proxy

Slots

Group

Sentinel

Benchmarks

See benchmark results

Authors

Active authors:

• @spinlock9 微博@斯宾洛克
• @yangzhe1991 微博@_杨肉_

Emeritus authors:

• @goroutine 微博@goroutine
• @c4pt0r 微博@Dongxu_Huang

Thanks:

• @ivanzhaowy
• @Apache9 微博@Apache9

License

Codis is licensed under MIT， see MIT-LICENSE.txt

---

You are welcome to use Codis in your product, and feel free to let us know~ :)