芯祥联科技 MQTT Broker 试用版使用说明书
版本说明
产品：XXL MQTT Broker V2.0.0 商用试用版
核心限制：单实例累计报文上限 100,000 条，无连接数、主题数、协议特性、运行时间限制
支持平台：Windows x64 / Linux x64 / Linux ARM32
不支持：ARM64（暂无编译服务平台，暂不提供二进制样例）
一、服务类型与访问方式
1. 命令行版 Broker（端口 1883）
运行方式：纯命令行程序，后台 / 前台运行均可
MQTT 接入端口：1883
功能：完整的 Broker 服务，支持 MQTT 3.1.1 / 5.0 全协议
2. 网桥 + GUI 一体化版（端口 8088）
运行方式：网桥程序 + Web 管理界面一体化
Web 管理访问：http://【网桥主机IP】:8088
MQTT 接入端口：8088（Web 管理与 MQTT 服务共用）
功能：支持连接监控、消息下发、客户端管理、日志查看
二、Web 管理界面核心功能（网桥 / GUI 版）
表格
功能模块	说明
启动 / 停止 Broker	一键启停服务，状态实时显示
在线客户端管理	查看在线列表、ClientID、连接时长，支持踢除异常客户端
消息下发测试	支持自定义主题、内容、QoS、Retain，模拟服务端下发消息
认证配置	支持设置用户名 / 密码，开启 / 关闭匿名访问
运行日志	实时打印连接、消息、系统事件日志，支持排错调试
三、命令行 Demo 菜单（1:1 还原）
text
=====================================================
  芯祥联科技 MQTT Broker SDK V2.0 测试程序
  版本：V2.0.0
=====================================================

===========================================
  芯祥联 MQTT Broker SDK 测试工具 V2.0
===========================================
 1. 创建并启动 Broker (端口:1883)
 2. 停止并销毁 Broker
 3. 获取在线客户端数量
 4. 获取客户端 ID 列表
 5. 查询客户端详细信息
 6. 踢掉指定客户端
 7. Broker 服务端发布消息
 8. 清除保留消息
 9. 获取 Broker 统计信息
 10. 查看 Broker 运行状态
 11. 查看保留消息主题列表
 12. 测试错误码字符串
 13. 设置日志级别
 0. 退出程序
===========================================
请输入选择：
四、第三方客户端接入说明（以 MQTTX 为例）
Broker 完全兼容 MQTT 标准协议，支持所有主流第三方客户端接入，如 MQTTX、MQTT.fx、mosquitto 等。
1. 接入配置（通用）
表格
配置项	命令行版 Broker	网桥 / GUI 版 Broker
服务器地址	运行 Broker 的主机 IP	运行网桥的主机 IP
端口号	1883	8088
协议	MQTT 3.1.1 / 5.0	MQTT 3.1.1 / 5.0
用户名 / 密码	无认证（默认匿名）/ 自定义	网桥 Web 界面配置的账号 / 密码
2. MQTTX 快速接入步骤
打开 MQTTX，点击「新建连接」
填写基本信息：
名称：自定义（如 XXL Broker Test）
服务器地址：选择 mqtt://，输入主机 IP（如 192.168.3.100）
端口：1883（命令行版）或 8088（网桥版）
客户端 ID：自定义（不可重复，如 mqttx_client_001）
认证配置：
匿名访问：无需填写用户名 / 密码
账号认证：填写网桥 Web 界面设置的用户名 / 密码（如 user/123456）
点击「连接」，连接成功后即可发布 / 订阅消息
五、试用版唯一限制说明
报文计数规则：累计处理所有 MQTT 报文（CONNECT、PUBLISH、SUBSCRIBE 等），上限为 100,000 条
限制触发行为：达到上限后，Broker 会拒绝新的消息发布 / 转发请求，但已建立的连接不会断开
计数重置方式：重启 Broker 服务即可清零计数，重新开始试用
无其他限制：无连接数、主题数、协议特性、运行时间的限制，支持全功能使用
六、快速测试流程（5 分钟完成）
启动 Broker：运行命令行 Demo，输入 1 启动服务（端口 1883）
客户端接入：使用 MQTTX 连接，填写主机 IP 和端口
订阅主题：在 MQTTX 订阅 test/topic
下发测试消息：
方式 1：在命令行 Demo 输入 7，按提示输入主题、内容，下发消息
方式 2：在网桥 Web 界面填写主题 test/topic 和消息内容，点击「下发消息」
验证接收：MQTTX 成功收到消息，说明接入正常
七、注意事项
端口占用：确保主机的 1883（命令行版）或 8088（网桥版）端口未被其他程序占用
防火墙设置：服务器部署时，需开放对应端口的 TCP 访问权限，否则外部设备无法连接
认证配置：网桥版 Broker 的用户名 / 密码修改后，客户端需同步更新，否则连接会被拒绝
数据持久化：Broker 支持会话、消息持久化，重启服务后会话和消息不会丢失
日志查看：命令行版日志直接打印在控制台，网桥版日志可在 Web 界面实时查看