create emqx project

Feng c85617c080 distributed session 10 年 前
deps 3a6ed9a876 0.2 project structure 11 年 前
doc 4ff7f9b2fe global unique id 10 年 前
include c85617c080 distributed session 10 年 前
rel ce5ca88cb6 comment 10 年 前
src c85617c080 distributed session 10 年 前
test c0d283aaa7 guid and fix clientid 10 年 前
.gitignore f25ceb1b2b ignore examples 10 年 前
.gitmodules 27efd4de26 rm tests 10 年 前
.travis.yml db6d9cc49b add 11 年 前
CHANGELOG.md 6b48493012 todo 10 年 前
LICENSE f33cf11cd5 emqtt.io 10 年 前
Makefile 613d38e288 dialyzer 10 年 前
README.md 8b7304c0dd fix contributors 10 年 前
rebar 2d2aa2f79a upgrade esockd, mochiweb 11 年 前
rebar.config 7009ef944b gproc 0.5 10 年 前

README.md

Overview Build Status

emqttd is a massively scalable and clusterable MQTT V3.1/V3.1.1 broker written in Erlang/OTP. emqttd support both MQTT V3.1/V3.1.1 protocol specification with extended features.

emqttd requires Erlang R17+ to build.

Goals

emqttd is aimed to provide a solid, enterprise grade, extensible open-source MQTT broker for IoT(M2M) applications that need to support ten millions of concurrent MQTT clients.

  • Easy to install
  • Massively scalable
  • Easy to extend
  • Solid stable

Features

  • Full MQTT V3.1/V3.1.1 protocol specification support
  • QoS0, QoS1, QoS2 Publish and Subscribe
  • Session Management and Offline Messages
  • Retained Messages Support
  • Last Will Message Support
  • TCP/SSL Connection Support
  • MQTT Over Websocket(SSL) Support
  • HTTP Publish API Support
  • $SYS/borkers/# Support
  • Client Authentication with clientId, ipaddress
  • Client Authentication with username, password.
  • Client ACL control with ipaddress, clientid, username.
  • Cluster brokers on several servers.
  • Bridge brokers locally or remotelly
  • 500K+ concurrent clients connections per server
  • Extensible architecture with Hooks, Modules and Plugins
  • Passed eclipse paho interoperability tests

Plugins

  • emqttd_auth_clientid - Authentication with ClientIds
  • emqttd_auth_mysql - Authentication with MySQL
  • emqttd_auth_ldap - Authentication with LDAP
  • emqttd_mod_autosub - Subscribe some topics automatically when client connected
  • emqttd_mod_presence - Publish presence message to $SYS topics when client connected or disconnected
  • emqttd_mod_rewrite - Topics rewrite like HTTP rewrite module

Design

emqttd architecture

QuickStart

Download binary packeges for linux, mac and freebsd from http://emqtt.io/downloads.

For example:

tar xvf emqttd-ubuntu64-0.7.0-alpha.tgz && cd emqttd

# start console
./bin/emqttd console

# start as daemon
./bin/emqttd start

# check status
./bin/emqttd_ctl status

# stop
./bin/emqttd stop

Build from source:

git clone https://github.com/emqtt/emqttd.git

cd emqttd && make && make dist

GetStarted

Read emqtt wiki for detailed installation and configuration guide.

Benchmark

Benchmark 0.6.1-alpha on a ubuntu/14.04 server with 8 cores, 32G memory from QingCloud:

200K+ Connections, 200K+ Topics, 20K+ In/Out Messages/sec, 20Mbps+ In/Out with 8G Memory, 50%CPU/core

License

The MIT License (MIT)

Contributors

Author

Feng Lee feng@emqtt.io