產品介紹
# 前言
本文檔為金蝶Apusic分佈式消息隊列for MQTT（Apusic Distributed Message Queue，簡稱：ADMQ for MQTT）的產品介紹，幫助用戶快速瞭解ADMQ for MQTT產品的功能、技術特性及典型應用場景。
# 適用對象
本文檔適用於IT信息化業務負責人、研發經理、軟件項目經理、軟件架構師、運維工程師。
# 相關文檔
瞭解更多 ADMQ for MQTT 產品相關的信息，請參閱以下產品手冊文檔集：
| 序號 | 手冊文檔 | 說明 |
|---|---|---|
| 1 | 金蝶Apusic分佈式消息隊列for MQTT 快速使用手冊 | 簡單介紹瞭如何快速上手使用ADMQ for MQTT 。 |
| 2 | 金蝶Apusic分佈式消息隊列for MQTT 安裝手冊 | 詳細介紹如何在各操作系統上安裝ADMQ for MQTT，以及ADMQ for MQTT服務啟停等操作。 |
| 3 | 金蝶Apusic分佈式消息隊列for MQTT 消息引擎用戶手冊 | 詳細介紹 ADMQ for MQTT 消息引擎相關功能的使用、配置、管理及配套工具的使用方法。 |
| 4 | 金蝶Apusic分佈式消息隊列for MQTT 管控臺用戶手冊 | 詳細介紹ADMQ for MQTT管控臺相關功能的使用和操作說明。 |
| 5 | 金蝶Apusic分佈式消息隊列for MQTT 開發手冊 | 詳細介紹基於各開發語言進行ADMQ for MQTT客戶端應用開發的說明。 |
| 6 | 金蝶Apusic分佈式消息隊列for MQTT 遷移手冊 | 詳細介紹從MQTT Broker遷移到ADMQ for MQTT的說明。 |
| 7 | 金蝶Apusic分佈式消息隊列for MQTT 運維手冊 | 詳細介紹ADMQ for MQTT的監控、運維、安全加固等運維說明。 |
| 8 | 金蝶Apusic分佈式消息隊列for MQTT 性能優化手冊 | 詳細介紹ADMQ for MQTT性能調優的說明。 |
# 技術支持
ADMQ for MQTT產品提供全面的技術支持服務，您可以通過以下方式獲得技術支持：
- 網址：www.apusic.com
- 電話：400-855-5800
- 郵箱：support@apusic.com
- 金蝶雲社區：https://vip.kingdee.com/?productId=73&productLineId=14&lang=zh-CN
您在取得技術支持時，請提供如下信息：
您的姓名
公司信息與聯繫方式
操作系統及其版本
產品版本號
出現異常及錯誤的日誌、截圖等詳細信息
# 產品簡介
# 產品定位
金蝶Apusic分佈式消息隊列for MQTT（Apusic Distributed Message Queue，簡稱：ADMQ for MQTT）是專為物聯網和移動互聯網場景打造的信創替代型企業級MQTT消息中間件，完全遵循MQTT核心協議規範，實現協議、客戶端、生態工具、業務場景的全兼容，無需改造即可替換原有MQTT Broker集群，滿足信創項目落地需求。
ADMQ for MQTT在保持原生MQTT協議兼容性的基礎上，提供安全認證、權限控制、可視化管控、規則引擎、數據橋接、運維監控等企業級能力。
# 核心價值
遵循MQTT輕量、高效、可靠的核心特性，同時適配信創軟硬件環境，提供海量設備接入能力、更穩定的運行保障、更便捷的運維支持及更全面的安全能力，成為物聯網消息中間件信創替代的優選方案。
# 核心能力
| 核心能力 | 解釋 |
|---|---|
| MQTT 協議完全兼容 | 完整兼容 MQTT 3.1、3.1.1、5.0 協議，行為與原生 MQTT Broker 一致。 |
| 全版本客戶端適配 | 支持 Eclipse Paho、MQTT.js等主流 MQTT 客戶端，無代碼改造即可接入。 |
| 生態工具無縫複用 | 兼容 MQTT 原生工具、監控系統（Prometheus+Grafana）等生態組件。 |
| 信創環境深度適配 | 適配主流信創操作系統（麒麟、統信等）、信創芯片（ARM、RISC-V 等），兼容信創數據庫及中間件生態。 |
| MQTT 核心特性繼承 | 支持發佈/訂閱模型、QoS 0/1/2、保留消息、遺囑消息、會話保持、主題通配符等原生核心特性。 |
| 企業級增強 | 支持規則引擎、數據橋接、認證授權、ACL 訪問控制、TLS/國密 SSL 加密等企業級能力。 |
# 產品架構
# 架構概述
ADMQ for MQTT採用分佈式集群架構，完全遵循MQTT協議與發佈訂閱模型。產品整體架構分為管控臺、核心引擎和分佈式協調三大模塊，具備高可靠、高可用、可擴展的特性。
# 管控臺（Console）
- 管控臺是面向運維人員和管理員的可視化操作界面，提供全生命週期管理能力：
- 集群管理：對MQTT集群節點進行接入和狀態監控。
- 用戶權限：基於角色的訪問控制（RBAC），保障操作安全。
- 客戶端管理：查看在線客戶端、訂閱關係、飛行中消息。
- 主題管理：管理Topic、主題重寫、自動訂閱、Topic監控。
- 認證授權：管理認證器、授權源、ACL權限規則。
- 消息管理：發送測試消息、管理保留消息。
- 監控告警：查看節點狀態、運行時監控、慢訂閱、告警信息。
# 核心引擎（Core Engine）
核心引擎是消息處理的核心，兼容MQTT協議，保障消息的可靠傳輸與分發：
MQTT 協議接入 & 安全訪問控制
提供標準 MQTT 協議兼容層，支持 TCP、SSL、WebSocket、WebSocket over SSL、QUIC 等多種接入方式。
集成認證（用戶名密碼、JWT、SCRAM）、授權（ACL）和傳輸加密（SSL/TLS、國密SSL），保障訪問安全。
消息處理服務
消息發佈接入：接收發布者（Publisher）發送的消息，進行校驗和主題匹配。
消息訂閱服務：向訂閱者（Subscriber）推送消息，支持 QoS 0/1/2 消息質量等級。
保留消息服務：為主題保留最後一條保留消息，新訂閱者立即收到。
遺囑消息服務：客戶端異常斷開時自動發佈遺囑消息。
會話保持服務：保存訂閱關係、未確認消息和離線消息，客戶端重連後可恢復。
高可用與負載管理
無狀態節點集群：節點間無狀態共享，支持任意節點故障切換。
自動故障恢復：節點故障時自動剔除異常節點，客戶端可重連到其他節點。
負載均衡：將客戶端連接均勻分配到集群節點，提升整體接入能力。
狀態監控：實時監控節點、連接、主題的健庨狀態，為故障恢復提供依據。
# 分佈式協調（Distributed Coordination）
分佈式協調模塊負責維護集群的一致性和狀態：
集群成員管理：維護集群中所有 MQTT 節點的在線 / 離線狀態。
會話狀態同步：在集群節點間同步客戶端會話狀態。
路由表管理：維護主題到訂閱者的路由關係。
集群狀態監聽通知：當集群狀態（如節點上下線、訂閱關係變化）發生變化時，向相關組件發送通知，觸發相應處理。
# 產品優勢
零改造信創替代：無需修改業務代碼、無需調整客戶端配置（僅需變更連接地址），即可直接替換原有 MQTT Broker，遷移成本趨近於零。
生態完全兼容：MQTT 原生工具、監控系統（Prometheus+Grafana）等均可直接複用，無需額外適配開發。
海量設備接入：支持百萬級併發連接，滿足大規模物聯網場景的設備接入需求。
信創環境適配：全面兼容信創軟硬件生態，滿足政企信創項目落地要求，提供端到端的信創解決方案。
安全合規增強：在保留 MQTT 原有安全能力基礎上，新增 ACL、TLS/國密 SSL、審計日誌等安全特性，符合信創項目安全合規標準。
靈活擴展能力：支持規則引擎、數據橋接，可與數據庫、消息隊列、流式計算引擎等系統集成。
# 應用場景
- 信創項目替代場景：政企信創改造中，直接替換原有 MQTT Broker，無需重構業務系統，快速滿足信創落地要求。
- 物聯網平臺場景：支持海量傳感器、智能設備接入，實現設備數據採集、命令下發、狀態監控。
- 車聯網場景：支持車輛終端接入，實現車輛狀態上報、遠程控制、OTA升級等。
- 移動消息推送場景：支持移動端App的消息推送、即時通訊、實時通知等。
- 工業互聯網場景：支持工業設備數據採集、設備預測性維護、生產監控等。
- 智能家居場景：支持智能家居設備聯動、語音控制、場景自動化等。