# smart-mqtt

**Repository Path**: smartboot/smart-mqtt

## Basic Information

- **Project Name**: smart-mqtt
- **Description**: 一款开源的云原生分布式 MQTT Broker 服务器，支持海量物联网设备互联互通。
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://smartboot.tech/smart-mqtt/
- **GVP Project**: No

## Statistics

- **Stars**: 794
- **Forks**: 157
- **Created**: 2018-04-27
- **Last Updated**: 2026-03-26

## Categories & Tags

**Categories**: iot

**Tags**: mqtt, broker, mqtt-broker, IOT

## README

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-blue.svg" alt="License"></a>
  <a href="https://gitee.com/smartboot/smart-mqtt/releases"><img src="https://img.shields.io/badge/version-v1.5.3-green.svg" alt="Version"></a>
  <a href="https://hub.docker.com/r/smartboot/smart-mqtt"><img src="https://img.shields.io/docker/pulls/smartboot/smart-mqtt.svg" alt="Docker"></a>
  <a href="https://smartboot.tech/smart-mqtt/"><img src="https://img.shields.io/badge/docs-官方文档-blue.svg" alt="Documentation"></a>
</p>

<p align="center">
  <b>高性能、插件化的企业级 MQTT Broker</b><br>
  单机支持百万连接，千万级消息吞吐
</p>

---

## 简介

smart-mqtt 是一款面向企业级物联网场景的高性能 MQTT Broker，采用 Java 语言开发，基于自研的异步非阻塞通信框架 [smart-socket](https://gitee.com/smartboot/smart-socket)，完整实现了 MQTT v3.1.1 和 v5.0 协议规范。

![项目架构](https://smartboot.tech/smart-mqtt/_astro/framework.Bj8Uk056_1FS6vN.svg)

### 核心优势

- **超高性能** - 异步非阻塞 I/O 架构，单机百万级并发连接，千万级消息吞吐，超低延迟处理
- **极致轻量** - 发行包体积小于 800KB，极少外部依赖，资源占用极低
- **开箱即用** - 零配置启动，无需复杂配置即可快速部署运行
- **插件架构** - 模块化设计，支持热插拔扩展，功能按需加载，无需重启服务
- **企业级高可用** - 原生支持多节点集群，自动负载均衡与故障转移
- **Java 生态** - 与现有 Java 技术栈零门槛集成，开发运维无缝衔接
- **标准兼容** - 完整遵循 MQTT 3.1.1/5.0 协议标准，支持 QoS 0/1/2 全质量等级

> ⚠️ **授权声明**：smart-mqtt 仅供个人学习使用，**未经授权禁止用于商业目的**。商业授权请联系 [smart-mqtt 官网](https://smartboot.tech/smart-mqtt/#enterprise)。

---

## 快速开始

### Docker 部署（推荐）

```bash
docker run --name smart-mqtt \
  -p 1883:1883 \
  -p 18083:18083 \
  -d smartboot/smart-mqtt:latest
```

- `1883` - MQTT 服务端口
- `18083` - Web 控制台（默认账号/密码：smart-mqtt / smart-mqtt）

### 本地部署

```bash
# 下载并解压
curl -LO https://gitee.com/smartboot/smart-mqtt/releases/download/v1.5.3/smart-mqtt-full-v1.5.3.zip
unzip smart-mqtt-full-v1.5.3.zip -d smart-mqtt && cd smart-mqtt

# 启动服务
./start.sh
```

---


## [插件生态](./plugins)

smart-mqtt 采用插件化架构，通过 `enterprise-plugin` 提供企业级 Web 管理控制台。

| 插件 | 功能 | 推荐场景 |
|------|------|----------|
| **[enterprise-plugin](./plugins/enterprise-plugin)** | Web 控制台、RESTful API、用户管理 | 生产环境必装 |
| **[cluster-plugin](./plugins/cluster-plugin)** | 多节点集群、负载均衡、节点发现 | 高可用部署 |
| **[websocket-plugin](./plugins/websocket-plugin)** | WebSocket 协议支持 | Web 应用 |
| **[mqtts-plugin](./plugins/mqtts-plugin)** | SSL/TLS 加密通信 | 安全敏感场景 |
| **[redis-bridge-plugin](./plugins/redis-bridge-plugin)** | 消息桥接至 Redis | 缓存集成 |
| **[simple-auth-plugin](./plugins/simple-auth-plugin)** | 用户名/密码认证、ACL 权限控制 | 基础认证 |

---

## 项目历程

```mermaid
timeline
    title smart-mqtt 发展历程
    2018 : 项目创立
         : 完成 MQTT 协议编解码基础框架
    2019-2021 : 聚焦 smart-socket 性能优化
    2022 : 重启 smart-mqtt
         : 完成 Broker 和 Client 核心功能
    2023 : 企业版立项
         : 启动 Web 控制台和插件系统开发
    2025 : 企业版功能全面开源
         : v1.5.x 正式发布
    2026 : AI 全面重构后台管理系统
         : 集成 Feat Agent 
```

---

## 文档与资源

- 📚 [官方文档](https://smartboot.tech/smart-mqtt/) - 完整的使用文档和 API 参考
- 🖥️ [在线演示](http://115.190.30.166:8083/) - 账号/密码：smart-mqtt / smart-mqtt
- 🐛 [问题反馈](https://gitee.com/smartboot/smart-mqtt/issues) - Gitee Issues

---

<p align="center">
  License: <b>AGPL-3.0</b> | 
  <a href="https://smartboot.tech/">smartboot 官网</a> |
  <a href="README.md">🇺🇸 English</a>
</p>