goim v2.0
![codecov](https://codecov.io/gh/Terry-Mao/goim/branch/master/graph/badge.svg)
goim is an im server writen in golang.
Features
- Light weight
- High performance
- Pure Golang
- Supports single push, multiple push and broadcasting
- Supports one key to multiple subscribers (Configurable maximum subscribers count)
- Supports heartbeats (Application heartbeats, TCP, KeepAlive, HTTP long pulling)
- Supports authentication (Unauthenticated user can't subscribe)
- Supports multiple protocols (WebSocket,TCP,HTTP)
- Scalable architecture (Unlimited dynamic job and logic modules)
- Asynchronous push notification based on Kafka
Architecture
![arch](https://gitee.com/leaf-rain-gitee/goim/raw/9b43e0071bf8/docs/arch.png)
Quick Start
Build
make build
Run
make run
make stop
// or
nohup target/logic -conf=target/logic.toml -region=sh -zone=sh001 -deploy.env=dev -weight=10 2>&1 > target/logic.log &
nohup target/comet -conf=target/comet.toml -region=sh -zone=sh001 -deploy.env=dev -weight=10 -addrs=127.0.0.1 2>&1 > target/logic.log &
nohup target/job -conf=target/job.toml -region=sh -zone=sh001 -deploy.env=dev 2>&1 > target/logic.log &
Environment
env:
export REGION=sh
export ZONE=sh001
export DEPLOY_ENV=dev
supervisor:
environment=REGION=sh,ZONE=sh001,DEPLOY_ENV=dev
go flag:
-region=sh -zone=sh001 deploy.env=dev
Configuration
You can view the comments in target/comet.toml,logic.toml,job.toml to understand the meaning of the config.
Dependencies
Discovery
Kafka
Document
Protocol
English
中文
Examples
Websocket: Websocket Client Demo
Android: Android
iOS: iOS
Benchmark
![benchmark](https://gitee.com/leaf-rain-gitee/goim/raw/9b43e0071bf8/docs/benchmark.jpg)
Benchmark Server
CPU |
Memory |
OS |
Instance |
Intel(R) Xeon(R) CPU E5-2630 v2 @ 2.60GHz |
DDR3 32GB |
Debian GNU/Linux 8 |
1 |
Benchmark Case
- Online: 1,000,000
- Duration: 15min
- Push Speed: 40/s (broadcast room)
- Push Message: {"test":1}
- Received calc mode: 1s per times, total 30 times
Benchmark Resource
- CPU: 2000%~2300%
- Memory: 14GB
- GC Pause: 504ms
- Network: Incoming(450MBit/s), Outgoing(4.39GBit/s)
Benchmark Result
中文
English
LICENSE
goim is is distributed under the terms of the MIT License.