技術規範
# 前言
本文檔為金蝶Apusic分散式訊息佇列for RabbitMQ（Apusic Distributed Message Queue，簡稱：ADMQ for RabbitMQ）的功能規格說明，協助使用者詳細了解ADMQ for RabbitMQ的產品功能與技術指標。
# 適用對象
本文檔適用於IT資訊化業務負責人、研發經理、軟體專案經理、軟體架構師、維運工程師。
# 相關文件
了解更多ADMQ for RabbitMQ產品相關的資訊，請參閱以下ADMQ for RabbitMQ產品手冊文件集：
| 序號 | 手冊文件 | 說明 |
|---|---|---|
| 1 | 金蝶Apusic分散式訊息佇列for RabbitMQ 快速使用手冊 | 簡單介紹了如何快速上手使用ADMQ for RabbitMQ 。 |
| 2 | 金蝶Apusic分散式訊息佇列for RabbitMQ 安裝手冊 | 詳細介紹如何在各作業系統上安裝ADMQ for RabbitMQ，以及ADMQ for RabbitMQ服務啟停等操作。 |
| 3 | 金蝶Apusic分散式訊息佇列for RabbitMQ 訊息引擎使用者手冊 | 詳細介紹 ADMQ for RabbitMQ 訊息引擎相關功能的使用、配置、管理及配套工具的使用方法。 |
| 4 | 金蝶Apusic分散式訊息佇列for RabbitMQ 管控台使用者手冊 | 詳細介紹ADMQ for RabbitMQ管控台相關功能的使用和操作說明。 |
| 5 | 金蝶Apusic分散式訊息佇列for RabbitMQ 開發手冊 | 詳細介紹基於各開發語言進行ADMQ for RabbitMQ用戶端應用開發的說明。 |
| 6 | 金蝶Apusic分散式訊息佇列for RabbitMQ 遷移手冊 | 詳細介紹從RabbitMQ遷移到ADMQ for RabbitMQ的說明。 |
| 7 | 金蝶Apusic分散式訊息佇列for RabbitMQ 維運手冊 | 詳細介紹ADMQ for RabbitMQ的監控、維運、安全強化等維運說明。 |
| 8 | 金蝶Apusic分散式訊息佇列for RabbitMQ 效能最佳化手冊 | 詳細介紹ADMQ for RabbitMQ效能調校的說明。 |
# 技術支援
ADMQ for RabbitMQ產品提供全面的技術支援服務，您可以透過以下方式獲得技術支援：
- 網址：www.apusic.com
- 電話：400-855-5800
- 信箱：support@apusic.com
- 金蝶雲社區：https://vip.kingdee.com/?productId=73&productLineId=14&lang=zh-CN
您在取得技術支援時，請提供如下資訊：
您的姓名
公司資訊與聯絡方式
作業系統及其版本
產品版本號
出現異常及錯誤的日誌、截圖等詳細資訊
# 產品版本與相容性
# 版本資訊
| 屬性 | 說明 |
|---|---|
| 產品名稱 | 金蝶Apusic分散式訊息佇列 |
| 產品版本 | ADMQ for RabbitMQ V2.0.6.391 |
| 發布日期 | 2026年3月 |
# 用戶端相容性
ADMQ for RabbitMQ V2.0.6.391 相容以下RabbitMQ用戶端版本：
| 用戶端類型 | 支援版本 | 說明 |
|---|---|---|
| Java | 5.x - 5.21.x | 官方 Java 用戶端（amqp-client） |
| Python | 2.x - 2.x | Pika 用戶端 |
| Go | 1.x - 1.x | amqp091-go 用戶端 |
| Node.js | 0.x - 0.10.x | amqplib 用戶端 |
| .NET | 6.x - 6.x | RabbitMQ.Client 用戶端 |
| PHP | 3.x - 3.x | php-amqplib 用戶端 |
# 協定相容性
| 協定 | 狀態 | 說明 |
|---|---|---|
| AMQP 0-9-1 | 支援 | 核心訊息傳輸協定 |
| AMQP 1.0 | 支援 | 擴展協定支援 |
| MQTT | 支援 | 輕量級物聯網協定 |
| STOMP | 支援 | 簡單文字協定 |
| SSL/TLS | 支援 | 加密傳輸 |
| SASL/PLAIN | 支援 | 明文認證 |
| SASL/SCRAM | 支援 | SCRAM 認證 |
# 核心功能特性
# 訊息收發
| 功能 | 說明 | 狀態 |
|---|---|---|
| 生產者（Producer） | 支援同步/非同步傳送、批次傳送、訊息持久化 | 支援 |
| 消費者（Consumer） | 支援推模式、拉模式、批次消費 | 支援 |
| 訊息確認 | 支援手動確認（Manual Ack）和自動確認（Auto Ack） | 支援 |
| 訊息持久化 | 訊息持久化到磁碟，支援多副本 | 支援 |
| 訊息優先級 | 支援訊息優先級佇列 | 支援 |
| 死信佇列 | 支援死信交換器（DLX）和死信佇列 | 支援 |
| 延遲佇列 | 支援延遲訊息和延遲佇列 | 支援 |
# 交換器（Exchange）
| 功能 | 說明 | 狀態 |
|---|---|---|
| Direct 交換器 | 精確匹配路由鍵 | 支援 |
| Fanout 交換器 | 廣播到所有綁定佇列 | 支援 |
| Topic 交換器 | 模式匹配路由鍵（支援萬用字元） | 支援 |
| Headers 交換器 | 基於訊息標頭匹配 | 支援 |
| 交換器建立/刪除 | 支援手動建立、自動建立 | 支援 |
| 交換器持久化 | 支援持久化交換器 | 支援 |
# 佇列（Queue）
| 功能 | 說明 | 狀態 |
|---|---|---|
| Classic 佇列 | 傳統佇列類型，支援映像 | 支援 |
| Quorum 佇列 | 基於 Raft 共識演算法的高可用佇列 | 支援 |
| Stream 佇列 | 僅附加日誌類型佇列，支援高吞吐量 | 支援 |
| 佇列建立/刪除 | 支援手動建立、自動建立 | 支援 |
| 佇列持久化 | 支援持久化佇列 | 支援 |
| 佇列綁定 | 支援 Exchange 到 Queue 的綁定 | 支援 |
| 佇列長度限制 | 支援最大長度和最大位元組限制 | 支援 |
| TTL | 支援訊息 TTL 和佇列 TTL | 支援 |
# 高可用與容錯
| 功能 | 說明 | 狀態 |
|---|---|---|
| 多副本 | Quorum Queue 和 Stream Queue 支援多副本 | 支援 |
| Raft 共識 | Quorum Queue 基於 Raft 演算法保證一致性 | 支援 |
| Leader 選舉 | 支援自動 Leader 選舉 | 支援 |
| 故障復原 | 支援自動故障轉移 | 支援 |
| 映像佇列 | Classic Queue 支援映像模式 | 支援 |
| 跨機房部署 | 支援跨機房多活部署 | 支援 |
# 安全特性
| 功能 | 說明 | 狀態 |
|---|---|---|
| 身分認證 | 支援 SASL/PLAIN/SCRAM 認證 | 支援 |
| 授權管理 | 支援基於 Vhost 的 ACL 存取控制 | 支援 |
| 傳輸加密 | 支援 SSL/TLS 加密 | 支援 |
| 角色控制 | 支援 RBAC 角色管理 | 支援 |
| 多租戶 | 支援 Vhost 資源隔離 | 支援 |
# 維運管理
| 功能 | 說明 | 狀態 |
|---|---|---|
| 監控指標 | 支援 Prometheus 指標匯出 | 支援 |
| 日誌管理 | 支援日誌級別配置和日誌輪替 | 支援 |
| 配置管理 | 支援動態配置更新 | 支援 |
| 叢集管理 | 支援節點新增/移除 | 支援 |
| 連線管理 | 支援連線數限制和心跳偵測 | 支援 |
# 技術規格
# 系統要求
| 組件 | 最低要求 | 建議配置 |
|---|---|---|
| CPU | 4 核 | 8 核以上 |
| 記憶體 | 8 GB | 16 GB 以上 |
| 磁碟 | 100 GB SSD | 500 GB 以上 SSD |
| 網路 | 1 Gbps | 10 Gbps |
| 作業系統 | Linux (CentOS 7+, Ubuntu 18.04+, 麒麟, 統信) | - |
# 叢集規模
| 部署模式 | 節點數量 | 說明 |
|---|---|---|
| 單機 | 1 | 開發測試環境 |
| 叢集 | 3-5 | 生產環境最小配置 |
| 大規模 | 10+ | 高可用高吞吐場景 |
# 效能指標
| 指標 | 單節點 | 3節點叢集 | 說明 |
|---|---|---|---|
| 吞吐量 | 5萬/秒 | 20萬/秒 | 生產者傳送速率 |
| 延遲 | 1ms | 1ms | P99 延遲 |
| 副本同步 | <1s | <1s | 副本同步延遲 |
| 故障復原 | <30s | <30s | Leader 切換時間 |
# 網路埠
| 埠號 | 用途 | 說明 |
|---|---|---|
| 5672 | AMQP 協定 | 生產者和消費者連線 |
| 5671 | AMQP over SSL | SSL 加密連線 |
| 15672 | Management HTTP | HTTP API 和 Web 管理介面 |
| 15671 | Management HTTPS | HTTPS API 和 Web 管理介面 |
| 25672 | Erlang Distribution | 叢集節點間通訊 |
| 12305 | 管控台 HTTP | 管控台 Web 介面（HTTP） |
| 12306 | 管控台 HTTPS | 管控台 Web 介面（HTTPS） |
# 支援的儲存
| 類型 | 支援情況 | 說明 |
|---|---|---|
| EXT4 | 支援 | Linux 標準檔案系統 |
| XFS | 建議 | 高效能檔案系統 |
| NFS | 支援 | 網路檔案系統（需配置） |
| 多碟掛載 | 支援 | 支援多資料目錄 |
# 部署模式
| 部署模式 | 節點數量 | 說明 |
|---|---|---|
| 單機模式 | 1 | 適用於開發測試環境，無高可用保證 |
| 叢集模式 | 3-10+ | 適用於生產環境，支援高可用保證和橫向擴展 |
| 映像佇列模式 | 3+ | 支援 Classic Queue 映像，提高資料可靠性 |
# 備份與災備
# 資料備份
| 備份方式 | 說明 |
|---|---|
| 副本備份 | 透過 Quorum Queue 和 Stream Queue 的多副本機制實現資料冗餘 |
| 定期備份 | 支援定期匯出佇列資料和配置 |
| 跨機房備份 | 支援 Shovel 和 Federation 跨機房同步 |
# 災備能力
| 災備等級 | 能力 |
|---|---|
| 節點故障 | 自動故障轉移，保證服務連續性 |
| 磁碟故障 | 多副本機制，單碟故障不影響服務 |
| 機房級 | 支援跨機房多活部署 |
| 資料安全 | 支援定期快照備份 |
编辑页面 (opens new window)