EMQ 管理控制檯功能簡介

EMQ 管理控制檯 (EMQ Dashboard，以下簡稱 Dashboard) 是 EMQ 提供的一個後端 Web 控制檯，使用者可通過 Web 控制檯檢視伺服器與叢集的執行狀態、統計指標，進行外掛配置與停啟、簡單的連線測試等操作。

關於 EMQ 的搭建與基本使用詳見文章 常見M QTT伺服器搭建與試用 ，EMQ 君不在此贅述。 基本使用

如果 EMQ 安裝在本機，則使用瀏覽器開啟地址 http://127.0.0.1:18083 ，輸入預設使用者名稱 admin 與預設密碼 public ，登入進入 Dashboard。如果忘記了管理控制檯密碼，使用 管理命令 重置或新建管理賬號。

主題與語言切換

Dashboard 介面與展示上提供暗色 (預設)、明亮兩種主題風格，中文、英文(預設)兩種語言支援。使用者可在 ADMIN (系統) -> Settings (設定) 中進行切換設定。

執行資料監控 Dashboard 提供 EMQ 單機與叢集的執行狀態監控功能，監控指標涵蓋伺服器基本資訊，裝置連線資訊，會話資訊，EMQ 當前主體與訂閱資訊。

控制檯

控制檯可檢視 EMQ 當前節點及伺服器叢集的基本資訊如伺服器版本、執行時間、CPU、記憶體、程式、執行統計等資料。

系統資訊、度量指標展示的是當前節點資料，使用者可以通過介面右上角下拉切換至叢集內其他節點；

節點資訊、執行統計展示叢集內的所有節點列表的資訊，標題括號內的數字即代表當前叢集內節點的數量。

控制檯展示的資料每隔 10 秒重新整理一次。

連線 連線介面可檢視當前客戶端的連線情況，通過右上角下拉切換按鈕可以切換檢視某節點內、叢集內的連線資訊；搜尋框可按照客戶端 ID (clientid) 進行搜尋。

會話

會話介面可檢視客戶端會話資訊如會話數、訂閱數等，其右上角切換、搜尋功能同上。

主題

主題介面可檢視叢集內所有主題資訊，右上角可進行主題搜尋。

訂閱

訂閱介面可檢視單節點/叢集內主題訂閱資訊，右上角切換、搜尋功能同連線與會話介面。

外掛與監聽

外掛

外掛介面可檢視當前節點外掛執行狀況，點選 啟動/停止 按鈕可以進行外掛的停啟，點選 配置 按鈕可以檢視並配置外掛引數。 關於外掛更詳細的介紹請看 擴充套件外掛。

出於安全性考慮，通過 Dashboard 配置的外掛引數不會持久化到配置檔案，即每次重啟 EMQ 後配置資訊會丟失。使用者通過介面上配置的外掛引數，在確認正確可用後應當將配置寫到 etc/plugins/ 目錄下響應的配置檔案中。

監聽器

監聽器介面可檢視節點下網路監聽狀況，包含有每個服務的監聽協議、地址與埠及其最大連線數與當前連線數。

工具與應用

WebSocket

該工具通過 WebSocket 與 EMQ 連線，提供客戶端連線、釋出/訂閱、訊息檢視功能。WebSocket 支援非加密連線 (預設 8083 埠) 與 SSL 加密連線 (預設 8084 埠)，但請注意使用加密連線時必須配置了 WebSocket 證書且主機地址填寫的是與證書對應的域名。

同一裝置(clientid) 只能有一個線上，請勿使用已連線的客戶端 clientid 進行連線測試。

HTTP 介面 HTTP 介面列舉了 Dashboard 所有 API 介面，點選路徑中的 URL 可以以當前登入使用者呼叫該介面並顯示資料，部分 POST/PUT/DELETE 方法介面不支援該操作。

應用

通過應用可以建立一個 API 介面憑證，用於呼叫 管理監控 API 監控伺服器、管理客戶端、釋出訂閱訊息等。

應用可以分配到期日期實現過期失效，如需暫時禁用應用，可以將其狀態置為 拒絕訪問。

使用者 管理 Dashboard 的登入使用者，支援新建、編輯、修改密碼等。

進階配置 Dashboard 繫結域名 使用單獨的域名或將 Dashboard 繫結到現有域名的某個路徑如 example.com/dashboard 下，參見文章： 使用 nginx 部署 EMQ Dashboard。