MQTT 即時儀表板 01:認識 MQTT 並建立雲端 Broker
這是「MQTT 即時儀表板」系列的第 1 篇。在上一個系列,我們用 HTTP 每分鐘把溫濕度送進 Google 試算表,這個做法簡單可靠。但如果你想要即時看到數據變化,或是想從網頁反過來控制開發板,就需要另一種更適合的通訊方式:MQTT。
・了解 MQTT 的發布與訂閱,以及主題(Topic)的規則
・免費建立 HiveMQ Cloud 雲端 Broker 與連線帳號
・用網頁客戶端完成第一次訊息收發測試
難度:入門 預估時間:40 分鐘 本篇不需要接硬體
一、為什麼要學 MQTT?
先說清楚:系列一的 HTTP 做法並沒有不好。如果你只是要定時記錄資料,HTTP 加上試算表完全夠用。MQTT 的優勢在於下面幾種情境:
- 即時性:裝置有新資料就立刻推出去,接收端不需要一直去問「有沒有新資料」。
- 雙向通訊:同一條連線,既能上傳資料,也能接收指令,例如從網頁按一個按鈕開關 LED。
- 一對多:一份資料可以同時被網頁、手機、資料庫等多個接收端使用,裝置不需要知道有誰在收。
- 輕量:訊息格式很精簡,很適合 ESP32 這類資源有限的裝置。
| 比較 | HTTP(系列一) | MQTT(本系列) |
|---|---|---|
| 通訊方式 | 每次傳送都要建立請求與回應 | 保持連線,隨時收發 |
| 資料流向 | 裝置主動送出,反向需要另外輪詢 | 天然雙向 |
| 接收端數量 | 通常一對一 | 一對多 |
| 適合 | 定時記錄、簡單上傳 | 即時監控、遠端控制 |
二、MQTT 的核心概念
MQTT 用的是「發布與訂閱」(Publish / Subscribe)的架構。它的運作可以用郵局和報紙來想像:
- Broker(中繼站):像郵局,負責接收所有訊息,並轉送給有訂閱的人。所有裝置與程式都只跟它連線。
- Client(客戶端):任何連到 Broker 的東西,ESP32、網頁、手機 App、後端程式都是。
- Topic(主題):像報紙的名稱,是訊息的「頻道」。發布者把訊息發到某個主題,訂閱了該主題的人就會收到。
- Publish(發布):把一則訊息送到某個主題。
- Subscribe(訂閱):告訴 Broker「我想收這個主題的訊息」。
- Payload(內容):訊息本身,可以是一段文字、數字,或是 JSON。
重點在於:發布者與訂閱者彼此不認識。ESP32 只管把資料發到主題,不需要知道網頁或手機是否在線,這讓系統很容易擴充。
三、主題的寫法與萬用字元
主題是用斜線分層的文字,像資料夾的路徑,例如:
iot/esp32-01/telemetry iot/esp32-01/status iot/esp32-01/cmd/led
訂閱時可以用兩種萬用字元,一次接收多個主題:
| 符號 | 意義 | 範例 |
|---|---|---|
+ |
取代「一層」 | iot/+/telemetry 收所有裝置的資料 |
# |
取代「後面所有層」,只能放在最後 | iot/esp32-01/# 收這台裝置的所有主題 |
命名習慣建議
- 使用英文小寫與連字號,避免空白與中文。
- 不要以斜線開頭,例如用
iot/...,而不是/iot/...。 - 由大到小分層:類別、裝置、資料種類。
- 發布時,主題中不能包含
+與#,這兩個符號只用在訂閱。
本系列的主題規劃
後續幾篇會使用下面這組主題(暫定,實作時可能微調):
| 主題 | 誰發布 | 內容 |
|---|---|---|
iot/esp32-01/telemetry |
ESP32 | 溫濕度,例如 {"temp":26.5,"hum":58} |
iot/esp32-01/status |
ESP32 | 上線或離線狀態 |
iot/esp32-01/cmd/led |
網頁儀表板 | LED 開關指令 |
四、三個之後會用到的概念
先有個印象就好,之後的文章會實際操作:
- QoS(服務品質):決定訊息的送達保證。0 代表「最多送一次」,可能掉訊息;1 代表「至少送一次」,可能重複;2 代表「剛好一次」,最嚴謹但也最耗資源。溫濕度這類持續更新的資料,用 0 或 1 就足夠。
- Retained(保留訊息):Broker 會記住某個主題的最後一則訊息,新的訂閱者一連上就能立刻拿到,不用等下一次更新。對儀表板很實用。
- LWT(遺囑訊息):裝置連線時先預設一則「遺言」,萬一裝置意外斷線,Broker 會代替它發出這則訊息,讓其他人知道它離線了。我們會用它做斷線偵測。
五、為什麼選 HiveMQ Cloud 當 Broker?
Broker 可以自己架設,也可以用雲端服務。為了讓你免安裝、免維護、最快上手,本系列使用 HiveMQ Cloud 的免費方案(Serverless)。我撰文時查到它的條件是:
- 免費、不需要信用卡
- 最多 100 個連線,每月 10 GB 流量
- 支援加密的 MQTT 連線(TLS)與 WebSocket(網頁可以直接連)
- 共用平台,沒有可用性保證(SLA)
以我們的用途來看,一台 ESP32 每分鐘發一則幾十個字元的訊息,流量遠遠用不到上限。但這個免費方案是為了學習與實驗設計的,不適合放在重要的正式環境。方案內容可能調整,請以 HiveMQ 官方價格頁面為準。
不會。MQTT 是通用標準,之後不管換成其他雲端服務或自己架設,程式裡只需要改主機位址、帳號與密碼,主題與程式邏輯都不用動。
六、建立 HiveMQ Cloud 叢集
- 前往 HiveMQ Cloud 主控台(https://console.hivemq.cloud/),註冊並登入帳號。
- 建立新的叢集(Cluster),方案選擇免費的 Serverless。
- 選擇一個區域。免費方案的可選區域有限,選擇你能選到的任一個即可,對溫濕度這類小量資料,延遲不是問題。
- 等待幾分鐘,叢集建立完成後,進入叢集的總覽(Overview)頁面,記下下面三項資訊:
| 項目 | 用途 |
|---|---|
| 叢集網址(Cluster URL) | Broker 的主機名稱,結尾通常是 .hivemq.cloud |
| TLS 連接埠 8883 | ESP32 與一般程式使用的加密 MQTT 連線 |
| WebSocket 連接埠 8884 | 網頁儀表板使用的連線(第 5 篇用到) |
七、建立連線帳號
Broker 不接受匿名連線,必須用帳號密碼認證。
- 在叢集頁面切換到「Access Management」分頁。
- 在 Credentials 區域新增一組憑證:
・Username:例如esp32-device
・Password:設定一組夠長、不容易猜的密碼
・Permission:選擇「Publish and Subscribe」(可發布也可訂閱) - 儲存。
本篇先用這一組帳號測試。之後的文章,我們會依用途拆開成裝置用與儀表板用兩組,並限制各自的權限。
拿到帳號密碼的人,就能對你的 Broker 收發訊息。請不要把密碼貼在文章、截圖、公開的程式碼庫中。分享截圖前,叢集網址、帳號與密碼都要塗掉。
八、用網頁客戶端做第一次測試
HiveMQ Cloud 在主控台內建了一個網頁版的 MQTT 客戶端,不用寫任何程式就能測試。
- 在叢集頁面,切換到「Web Client」分頁。
- 輸入剛剛建立的帳號與密碼,按 Connect。連線成功時,狀態會變成綠色。
- 訂閱:在訂閱區新增訂閱,主題輸入
iot/esp32-01/#。 - 發布:在發布區輸入主題
iot/esp32-01/test,訊息內容輸入hello,按 Publish。 - 幾乎同時,訊息列表會出現剛剛發布的 hello,代表 Broker 已經把訊息轉送給訂閱者,也就是你自己。
再試試看
- 發布一則 JSON:主題
iot/esp32-01/telemetry,內容{"temp":26.5,"hum":58},觀察是否收到。 - 發布到
iot/esp32-02/telemetry,看看iot/esp32-01/#的訂閱不會收到,因為裝置名稱不同。 - 新增另一個訂閱
iot/+/telemetry,再分別發布到兩台裝置的 telemetry,體會+的作用。
九、常見問題
- Web Client 一直顯示斷線:先確認帳號密碼輸入正確。可以回到 Access Management 重新建立一組新的憑證再試。網頁客戶端使用 WebSocket(8884),如果你的網路環境擋掉這個埠,可能連不上,可以換手機熱點測試。
- 找不到 Web Client 或選單名稱不同:雲端服務的介面會更新,請依你實際看到的畫面操作,核心流程不變:建立叢集、建立憑證、連線、訂閱、發布。
- 發布了但沒收到:確認訂閱的主題與發布的主題相符,大小寫也要一致;確認有按下訂閱確認。
- 想知道連線與流量用量:叢集總覽頁面會顯示基本的使用狀況。
十、延伸挑戰
- 建立第二組只有「訂閱」權限的憑證(如果你的方案有提供),試著用它發布,看看會被拒絕。
- 如果你有手機,可以搜尋安裝一個 MQTT 客戶端 App,連上同一個 Broker,和網頁客戶端互傳訊息。
- 設計一組你自己的主題命名規則,並寫下來,例如不同房間的裝置要怎麼命名。
下一篇預告
Broker 已經準備好了。下一篇我們要讓 ESP32 連上 HiveMQ Cloud,把 DHT11 的溫濕度用 MQTT 發布出去,並在網頁客戶端即時看到數據。
系列:MQTT 即時儀表板
目錄:系列總整理 | 下一篇:讓 ESP32 發布溫濕度
留言
張貼留言