# mmqtt **Repository Path**: sunhacker/mmq ## Basic Information - **Project Name**: mmqtt - **Description**: An Open-Source, Distributed MQTT Message Broker for IoT. - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 15 - **Created**: 2022-01-14 - **Last Updated**: 2022-06-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # MMQ broker *MMQ broker* 是一款完全开源,高度可伸缩,高可用的分布式 MQTT 消息服务器,适用于 IoT、M2M 和移动应用程序。 *MMQ broker* 完整支持MQTT V3.1 和 V3.1.1。 ## 安装 *MMQ broker* 是跨平台的,支持 Linux、Unix、macOS 以及 Windows。这意味着 *MMQ broker* 可以部署在 x86_64 架构的服务器上。由于使用raft一致性算法,集群部署三个节点以上。 #### 从 Github 上下载源码方式 ```bash git clone https://github.com/MrHKing/mmq.git cd mmq mvn -Prelease-mmq -Dmaven.test.skip=true clean install -U ``` #### 直接安装 您可以从 最新稳定版本 下载 mmq-server-$version.zip 包。 ```bash unzip mmq-server-$version.zip 或者 tar -xvf mmq-server-$version.tar.gz cd mmq/bin ``` #### Docker安装 ```bash docker run -d --name mmq -p 2883:2883 -p 1883:3883 -p 8888:8888 paperman/mmq:v1.0.8 ``` #### Kubernetes安装 # 快速入门 ### 单机版启动 ```bash cd mmq\bin #windows start startup.cmd -m standalone ``` ```bash cd mmq/bin #linux start sh startup.sh -m standalone #linux shutdown sh shutdown.sh ``` ### 集群版启动 ```bash cd mmq/config #配置集群文件 cp cluster.conf.example cluster.conf ``` ```bash #每个节点都需要配置其他节点的地址,如下: #example 192.168.31.9:7777 192.168.31.9:8848 192.168.31.9:8888 ``` ```bash cd mmq\bin #windows start startup.cmd ``` ```bash cd mmq/bin #linux start sh startup.sh #linux shutdown sh shutdown.sh ``` ### 配置文件 mqtt tcp端口默认:3883 mqtt websocket端口:2883 ```bash #*************** 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.enabled=false mmq.broker.ssl.password=true 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](https://github.com/MrHKing/mmq/wiki) ## MQTT 规范 你可以通过以下链接了解与查阅 MQTT 协议: [MQTT Version 3.1.1](https://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html) ## 开源许可 Apache License 2.0, 详见 [LICENSE](./LICENSE)。 ## 群号 QQ群: 1016132679