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)的架構。它的運作可以用郵局和報紙來想像:

MQTT 發布與訂閱示意圖 ESP32 發布者 Publisher Broker 訊息中繼站 網頁儀表板 訂閱者 手機或程式 訂閱者 發布 轉送 主題(Topic):iot/esp32-01/telemetry 裝置與接收端彼此不直接連線
  • 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 官方價格頁面為準。

換別的 Broker 會很難嗎?
不會。MQTT 是通用標準,之後不管換成其他雲端服務或自己架設,程式裡只需要改主機位址、帳號與密碼,主題與程式邏輯都不用動。

六、建立 HiveMQ Cloud 叢集

  1. 前往 HiveMQ Cloud 主控台(https://console.hivemq.cloud/),註冊並登入帳號。
  2. 建立新的叢集(Cluster),方案選擇免費的 Serverless。
  3. 選擇一個區域。免費方案的可選區域有限,選擇你能選到的任一個即可,對溫濕度這類小量資料,延遲不是問題。
  4. 等待幾分鐘,叢集建立完成後,進入叢集的總覽(Overview)頁面,記下下面三項資訊:
項目 用途
叢集網址(Cluster URL) Broker 的主機名稱,結尾通常是 .hivemq.cloud
TLS 連接埠 8883 ESP32 與一般程式使用的加密 MQTT 連線
WebSocket 連接埠 8884 網頁儀表板使用的連線(第 5 篇用到)

七、建立連線帳號

Broker 不接受匿名連線,必須用帳號密碼認證。

  1. 在叢集頁面切換到「Access Management」分頁。
  2. 在 Credentials 區域新增一組憑證:
     ・Username:例如 esp32-device
     ・Password:設定一組夠長、不容易猜的密碼
     ・Permission:選擇「Publish and Subscribe」(可發布也可訂閱)
  3. 儲存。

本篇先用這一組帳號測試。之後的文章,我們會依用途拆開成裝置用與儀表板用兩組,並限制各自的權限。

密碼要當成機密保管
拿到帳號密碼的人,就能對你的 Broker 收發訊息。請不要把密碼貼在文章、截圖、公開的程式碼庫中。分享截圖前,叢集網址、帳號與密碼都要塗掉。

八、用網頁客戶端做第一次測試

HiveMQ Cloud 在主控台內建了一個網頁版的 MQTT 客戶端,不用寫任何程式就能測試。

  1. 在叢集頁面,切換到「Web Client」分頁。
  2. 輸入剛剛建立的帳號與密碼,按 Connect。連線成功時,狀態會變成綠色。
  3. 訂閱:在訂閱區新增訂閱,主題輸入 iot/esp32-01/#。
  4. 發布:在發布區輸入主題 iot/esp32-01/test,訊息內容輸入 hello,按 Publish。
  5. 幾乎同時,訊息列表會出現剛剛發布的 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 發布溫濕度

留言

熱門文章