EMQX · 全球最可扩展的 MQTT 物联网消息平台｜部署与使用全指南
项目仓库： https://github.com/emqx/emqx
开源协议：Business Source License（BSL）1.1（自 v5.9.0 起统一开源/企业版） · 语言：Erlang · 部署：Docker / 二进制 / K8s Operator · 端口：1883/8883/8083/8084/18083 · 官方文档：docs.emqx.com
1 项目简介
EMQX 是面向高性能、可靠、安全 IoT 数据基础设施的 MQTT 平台，支持 MQTT 5.0/3.1.1/3.1 以及 MQTT-SN、CoAP、LwM2M、MQTT over QUIC 等协议。单集群可连接上亿并发 MQTT 客户端，每秒处理数百万消息，亚毫秒延迟。自 v5.9.0 起，原开源版与企业版功能统一为单一发行版，采用 BSL 1.1 协议。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | EMQX |
| 仓库地址 | github.com/emqx/emqx |
| 项目定位 | 分布式 MQTT 物联网消息平台 |
| 开源协议 | BSL 1.1（v5.9.0+） |
| 语言 | Erlang |
| MQTT 端口 | 1883（明文）/ 8883（TLS） |
| Dashboard 端口 | 18083 |
| WebSocket | 8083 / 8084 |
| 官方文档 | docs.emqx.com |
1.2 适用场景
- 海量 IoT / IIoT / 车联网 / 智慧城市设备接入。
- 实时消息路由与规则引擎数据处理。
- 与 Kafka、数据库、云服务等后端数据集成。
1.3 能力边界（官方口径）
- v5.9.0 起开源版与企业版合并为单一 BSL 发行版，商业使用条款见 License 说明。
- 单机 Docker 用于入门；生产用集群（Operator）。
2 功能特性
- 全协议支持：MQTT v5.0/3.1.1/3.1、MQTT over QUIC、LwM2M/CoAP/MQTT-SN 网关。
- 大规模集群：单集群 1 亿+ 并发客户端，无主集群。
- 规则引擎：SQL 处理、转换、过滤消息流。
- 数据集成：50+ 后端（Kafka/RabbitMQ/MySQL/PostgreSQL/Redis/ClickHouse/InfluxDB 等）与 Webhook。
- 消息队列 / Flow Designer / Smart Data Hub。
- 安全：TLS/SSL、WSS、JWT/PSK/X.509 认证、ACL、LDAP/SQL/Redis 认证库。
- 可观测：Prometheus/Grafana/Datadog/OpenTelemetry。
3 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 仓库主页 | https://github.com/emqx/emqx | 源码 |
| 安装文档 | install | 安装方式 |
| Docker 安装 | install-docker | 容器指南 |
| K8s Operator | EMQX Operator | 集群部署 |
| 下载 | emqx.com/downloads | 二进制 |
4 前置要求
- Docker（容器方式）。
- 端口放行：1883、8883、8083、8084、18083。
5 方式一：Docker 单节点（官方快速开始）
docker run -d --name emqx \
-p 1883:1883 -p 8083:8083 -p 8084:8084 \
-p 8883:8883 -p 18083:18083 \
emqx/emqx-enterprise:latest启动后浏览器访问 Dashboard http://127.0.0.1:18083。
6 方式二：Kubernetes 集群
通过官方 EMQX Operator 部署，见 Operator 文档。
7 方式三：下载二进制
从 官方下载页 下载最新版自行安装管理。
8 端口与协议
| 端口 | 协议 | 用途 |
|---|---|---|
| 1883 | MQTT | 明文接入 |
| 8883 | MQTT/TLS | 加密接入 |
| 8083 | MQTT over WS | WebSocket |
| 8084 | MQTT over WSS | 加密 WebSocket |
| 18083 | HTTP | Dashboard |
9 常见故障排查
- Dashboard 打不开：确认 18083 已映射且容器运行中。
- 设备连不上 1883：检查防火墙与安全组放行 1883。
- 集群 License 限制：v5.9.0+ 集群功能受 BSL/License 约束，见官方说明。
10 风险与合规说明
- 许可证：v5.9.0+ 为 BSL 1.1，商业使用需阅读 License 条款。
- 镜像名：官方快速开始使用
emqx/emqx-enterprise:latest。 - 非官方声明：本文基于官方仓库 README 整理，命令与端口以最新 release 为准。