EMQX

EMQX 是高性能 MQTT Broker，适合设备规模较大、需要 Dashboard、认证、ACL、规则引擎、数据桥接和集群能力的场景。早期资料里常见的 “EMQ” 一般指现在的 EMQX 生态。

Docker 快速测试

开发测试可以先用 Docker 启动：

1
2
3
4
5
6
7

docker run -d --name emqx \
-p 1883:1883 \
-p 8083:8083 \
-p 8084:8084 \
-p 8883:8883 \
-p 18083:18083 \
emqx/emqx:latest

生产环境建议固定明确版本，不要长期使用 latest。

查看状态：

1
2

docker ps
docker logs -f emqx

访问 Dashboard：

1

http://服务器IP:18083

默认账号、初始密码和安全策略以当前安装版本提示为准，首次登录后应立即修改。

常见端口

端口是否对外开放，要根据安全需求决定。生产环境不建议把管理面板暴露给全网。

测试连接

订阅：

1

mosquitto_sub -h 127.0.0.1 -p 1883 -t 'test/#' -v

发布：

1

mosquitto_pub -h 127.0.0.1 -p 1883 -t 'test/hello' -m 'hello emqx'

如果本机测试正常，外部设备连不上，再检查安全组、防火墙、端口映射和认证。

认证和 ACL

生产环境不要匿名开放。常见认证方式：

• 内置数据库账号。
• MySQL、PostgreSQL、Redis。
• HTTP 认证接口。
• JWT。
• 客户端证书。

权限设计建议：

• 设备只能发布自己的上行 topic。
• 设备只能订阅自己的下行 topic。
• 管理服务可以订阅多设备 topic。
• 不给普通设备 # 通配符权限。

数据桥接

EMQX 常用于把 MQTT 消息桥接到：

• HTTP API。
• MySQL、PostgreSQL。
• Kafka。
• Redis。
• Webhook。
• 云服务。

桥接前先明确消息格式、失败重试、幂等处理和死信处理。不要把所有 topic 无差别写入数据库。

常见问题

官方入口

• EMQX Documentation
• EMQX Docker Installation