Skip to content

MrHKing/mmqtt

Repository files navigation

GitHub issues Build Status 简体中文 | English

MMQ broker

  • MMQ broker* 是一款完全开源,高度可伸缩,高可用的分布式 MQTT 消息服务器,适用于 IoT、M2M 和移动应用程序。
  • MMQ broker* 完整支持MQTT V3.1 和 V3.1.1。
  • 开源免费 同时支持分布式架构和数据持久化、规则引擎、ACL的MQTT broker。
  • 在1.1.4版本新增插件功能,可以实现更多定制化功能。

特征

  • 分布式MQTT服务

  • 万级连接数并发(3台 华为云1核2G 1M带宽)

  • MQTT V3.1 和 V3.1.1

  • 支持桥接(MYSQL、POSTGRESQL、SQLSERVER、KAFKA、TDENGINE、MQTT BROKER、Influxdb)

  • 规则引擎 通过SQL进行规则转发

  • 管理API 对MMQ BROKER管理接口。

  • 认证鉴权 登录认证管理

  • 发布订阅 ACL

  • 插件模块

  • 集群管理 在线配置和管理集群*

    *为正在开发中的功能

安装

MMQ broker 是跨平台的,支持 Linux、Unix、macOS 以及 Windows。这意味着 MMQ broker 可以部署在 x86_64 架构的服务器上。由于使用raft一致性算法,集群部署三个节点以上。

从 Github 上下载源码方式

git clone https://github.com/MrHKing/mmq.git
cd mmq
mvn -Prelease-mmq -Dmaven.test.skip=true clean install -U

直接安装

您可以从 最新稳定版本 下载 mmq-server-$version.zip 包。

unzip mmq-server-$version.zip 或者 tar -xvf mmq-server-$version.tar.gz
cd mmq/bin

Docker安装

docker run -d --name mmq -p 2883:2883 -p 1883:3883 -p 8888:8888  paperman/mmq:v1.0.8

Kubernetes安装

快速入门

单机版启动

cd mmq\bin
#windows start
startup.cmd -m standalone
cd mmq/bin
#linux start
sh startup.sh -m standalone
#linux shutdown
sh shutdown.sh

集群版启动

cd mmq/config
#配置集群文件
cp cluster.conf.example cluster.conf
#每个节点都需要配置其他节点的地址,如下:
#example
192.168.31.9:7777
192.168.31.9:8848
192.168.31.9:8888
cd mmq\bin
#windows start
startup.cmd
cd mmq/bin
#linux start
sh startup.sh
#linux shutdown
sh shutdown.sh

配置文件

mqtt tcp端口默认:3883

mqtt websocket端口:2883

#*************** Spring Boot Related Configurations ***************#
### Default web context path:
server.servlet.contextPath=/
### Default web server port:
server.port=8888

#*************** mqtt broker Configurations ***************#
mmq.broker.websocketPort=2883
mmq.broker.port=3883
mmq.broker.ssl.password=mmq
mmq.broker.ssl.certPath=cert/mmq.pfx
mmq.broker.ssl.port=17733
mmq.broker.ssl.websocketPort=36633
mmq.broker.default.user=admin
mmq.broker.default.password=admin@mmq
mmq.broker.default.anonymous=true

Dashboard --单机演示

启动后访问 http://101.43.4.211:8888/

默认账户:mmq

默认密码:aaaaaa

mqtt tcp端口默认:1883

mqtt websocket端口:2883

文档

详细参见 wiki

MQTT 规范

你可以通过以下链接了解与查阅 MQTT 协议:

MQTT Version 3.1.1

开源许可

Apache License 2.0, 详见 LICENSE

群号

QQ群: 1016132679