# smqttx

**Repository Path**: logicjwell/smqttx

## Basic Information

- **Project Name**: smqttx
- **Description**: 基于Java实现的分布式MQTT集群，SMQTT的升级版本！欢迎大家使用，顺便动动小手Star一下!
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://www.smqtt.cc/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 114
- **Created**: 2024-08-10
- **Last Updated**: 2024-08-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">SMQTTX</h1>



<p align="center">

<a href=" https://github.com/quickmsg/smqttx/blob/release/ignite/README.md">
<img alt="apache" src="https://img.shields.io/badge/license-Apache%202 -blue"/>
</a>

<a href=" https://projectreactor.io/docs/netty/release/reference/index.html">
<img alt="reactor-netty" src="https://img.shields.io/badge/reactor--netty-1.0.22-blue"/>
</a>

<a href=" https://projectreactor.io/docs/core/release/reference/">
<img alt="reactor3" src="https://img.shields.io/badge/reactor3--netty-3.4.22-yellow"/>
</a>

<a href="">
<img alt="ignite" src="https://img.shields.io/badge/ignite-2.14.0-yellowgreen"/>
</a>

<a href=" https://projectreactor.io/docs/netty/release/reference/index.html">
<img alt="ignite" src="https://img.shields.io/badge/mqtt-3.1.1-green"/>
</a>

</p>



<div align="center">

<strong>

<samp>

[English](README-EN.md) · [Simplified Chinese](README.md)


</samp>

</strong>

</div>



## Function list



<details>
<summary>Click I open/close the function list</summary>

- [Standard MQTT Protocol](#Internationalization)
- [Websocket Protocol](#ContentDirectory)
- [TLS/SSL Encryption](#ContentDirectory)
- [Service Level](#ProjectIntroduction)
  - [qos0 at most once](#OfficialAebsite)
  - [qos1 at least once](#OfficialAebsite)
  - [qos2 only once](#OfficialAebsite)
- [Topic Filtering](#GraphicDemo)
  - [# Multi level matching](#fficialwebsite)
  - [+first level matching](#officialwebsite)
- [Reserved Message](#Function)
- [HTTP Protocol](#Schema)
- [Interceptor](#QuickStart)
- [Metrics Health](#QuickStart)
- [Rule Engine](#Maintainer)
- [Rule Management](#OfficialWebsite)
- [Data source management](#officialWebsite)
- [Cluster](#Maintainer)
- [Distributed Cluster Routing](#Maintainer)
- [Distributed Node Dynamic Discovery](#Maintainer)
- [Distributed Job](#Maintainer)
- [Cluster Kick Off Strategy](#Maintainer)
- [SMQTTX Management Platform](#QuickStart)
- [SpringBoot Starter](#Contributor)
- [Apacche 2](#License)

</details>



## Project introduction

![smqttx](icon/smqttx-en.jpg)



Java based distributed MQTT message proxy server for Internet of Things



### Official website



[Official website address]（ https://www.smqtt.cc )



### Background

The distributed MQTT cluster is implemented based on Netty, and provides fast access and configuration capabilities. It provides a unified access management platform. It can complete the access of tens of millions of devices without complex configuration.




## Quick Start



[![smqttx]( https://img.shields.io/badge/smqtt-2.0.0-green )]( https://www.smqtt.cc )


### Dependency

```xml

<dependency>
  <artifactId>smqttx-spring-boot-starter</artifactId>
  <groupId>io.github.quickmsg</groupId>
  <version>2.0.11</version>
</dependency>
        <!--Mask h2 database version conflicts-->
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<version>1.4.197</version>
</dependency>
```
### Config
application.yaml add config:

[config](config/config.yaml)

### Start
Add on the SpringBootApplication startup class

`@EnableMqttServer ', and then start the service



Please check config you want:



| File Name      | Style Preview|
|----------------|----------------------------------------------------------------------------------------------------|
| -----------    |-----------------------------------------------------|
| mqtt config    | https://wiki.smqtt.cc/smqttx/mqtt/1.mqtt.html       |
| acl config     | https://wiki.smqtt.cc/smqttx/acl/1.acl.html         |
| auth config    | https://wiki.smqtt.cc/smqttx/auth/1.auth.html       |
| http config    | https://wiki.smqtt.cc/smqttx/http/1.http.html       |
| ws config      | https://wiki.smqtt.cc/smqttx/ws/1.ws.html           |
| cluster config | https://wiki.smqtt.cc/smqttx/cluster/1.cluster.html |
| ssl/tls config       | https://wiki.smqtt.cc/smqttx/ssl/1.ssl.html         |



## Maintainer



Thanks to the maintainers of these projects:

<a href=" https://github.com/1ssqq1lxr ">

<img src=" https://avatars.githubusercontent.com/u/19258331?v=4 " width="40" height="40" alt="misitebao" title="misitebao"/>

</a>



<details>

<summary>Click I Open/Close Maintainer List</summary>



- [MetaQ]( https://github.com/1ssqq1lxr ）- SMQTTX project maintainer.

</details>[



## Contributors



Thank all the contributors who participated in the development of SMQTTX. [List of contributors]（ https://github.com/quickmsg/smqttx/graphs/contributors )



## Components



- [Reactor-Netty]( https://projectreactor.io/docs/netty/release/reference/index.html ）- High performance network framework

- [Reactor3]( https://projectreactor.io/docs/core/release/reference/ ）- Reactive framework implementation based on Reactor3

- [Ignite]( http://ignite-service.cn/ ）- High performance distributed network service cache

- [WebSite]( https://www.smqtt.cc ）- Project official website

- [Wiki]( https://wiki.smqtt.cc ）- Project documentation



## License

[License APACHE 2.0](LICENSE)

## Contact We
Add WeChat `17512575402`