WuKongIM: A Go repository from huashuiwujiale

悟空IM（让信息传递更简单）

9年积累，沉淀出来的高性能通用通讯服务，支持即时通讯，站内/系统消息，消息中台，物联网通讯，音视频信令，直播弹幕，客服系统，AI通讯，即时社区等场景。

本项目需要在go1.20.0或以上环境编译

2.0.0-beta版本发布正式发布！（beta版本不建议上生产，生产请使用1.2.x的版本）

分布式IM重要特性：故障自动转移，去中心化设计，节点之间数据互备，支持集群快速自动扩容，代理节点机制

English

官网: https://githubim.com
通讯协议: WuKongIM协议
提问: https://github.com/WuKongIM/WuKongIM/issues
文档: https://githubim.com

架构图

演示

聊天Demo

web聊天场景演示： http://imdemo.githubim.com

后端监控演示： http://monitor.githubim.com/web

特点

🎦独特性

群成员无上限，轻松支持10万人群聊，消息可永久存储。

📚资源消耗低

自研二进制协议，心跳包只有1字节，省流量，省电量，传输更迅速。

🔐安全性

消息通道和消息内容全程加密，防中间人攻击和窜改消息内容，服务端数据实时备份，数据不丢失。

🚀 性能

基于pebble kv数据库，研发了针对于IM这种服务的特有分布式数据库，省了其他数据库为了通用性而带来的性能损耗，因为存储快，所以消息快。

🔥高可用

通过魔改raft分布式协议，实现了自动容灾，一台机器宕机，另一台机器自动接管，对外无感知。

去中心化，无单点，无中心节点，每个节点都是独立且平等的，都可以提供服务。

扩容方便，只需增加机器，不需要停机，不需要迁移数据，自动按策略分配数据。

0⃣️ 易用性

不依然任何第三方中间件，部署简单，一条命令即可启动。

采用频道订阅发布的设计理念，容易理解，容易上手。

与Redis一样简单，Kafka一样高性能，MySQL一样可靠

🌲技术支持

官方团队提供技术支持，提供技术文档，提供技术交流群，提供issue反馈。

功能特性

快速部署体验

git clone https://github.com/WuKongIM/WuKongIM.git

cd WuKongIM/docker/cluster

sudo docker compose up -d

后台管理系统： http://127.0.0.1:15300/web

聊天演示地址：http://127.0.0.1:15172/login

源码开发

单机

go run main.go

(或 go run main.go --config config/wk.yaml)

分布式

# 启动第一个节点
go run main.go --config  ./exampleconfig/cluster1.yaml

# 启动第二个节点
go run main.go --config  ./exampleconfig/cluster2.yaml

# 启动第三个节点
go run main.go --config  ./exampleconfig/cluster3.yaml

访问

后台管理系统： http://127.0.0.1:5300/web

聊天演示地址：http://127.0.0.1:5172/chatdemo

正式部署

请参考部署文档

配套SDK源码和Demo

项目名	Github地址	Example	文档	说明
WuKongIM	Github	无	文档	悟空IM通讯端，负责长连接维护，消息投递等等
WuKongIMAndroidSDK	Github	Example	文档	悟空IM的Android SDK
WuKongIMiOSSDK	Github	Example	文档	悟空IM的iOS SDK
WuKongIMUniappSDK	Github	Example	文档	悟空IM的 Uniapp SDK
WuKongIMJSSDK	Github	Example	文档	悟空IM的 JS SDK
WuKongIMFlutterSDK	Github	Example	文档	悟空IM的 Flutter SDK
WuKongIMReactNativeDemo	Github	无	无	悟空IM的 React Native Demo(由贡献者 wengqianshan 提供)
WuKongIMHarmonyOSSDK	Github	Example	文档	WuKongIM的纯血鸿蒙OS SDK