Node-RED 入門：從安裝到第一個會動的流程

charles

這篇的內容（16 段）

1. 先講三個名詞，之後不再解釋
2. 什麼時候值得開 Node-RED
3. 步驟 2：安裝
4. 步驟 4：第一次進畫面
5. 步驟 5：接上 Home Assistant
6. 步驟 6：把節點的 Entity 填好
7. 步驟 9：馬上做一次備份
8. 常用的節點，一次認完
9. Home Assistant 那組（藍色）
10. Node-RED 內建那組
11. 一、忘記按 Deploy
12. 二、無限迴圈
13. 三、debug 節點忘記關
14. 四、重啟之後流程行為怪怪的
15. 五、節點右上角有紅色三角形
16. 做完這篇，你手上有什麼

Home Assistant 的自動化寫到有分支、有計時、有例外的時候，YAML 會變成一大塊看不懂的東西。Node-RED 是另一條路：把邏輯畫成方塊和線。



這篇從零做到「開門走廊燈亮、而且只在天黑時亮」，中間每一步都有「你會看到什麼」。做完你手上會有一個真的在跑的流程，不是一張示意圖。

先講三個名詞，之後不再解釋

• 節點（node） —— 畫面上的一個方塊，做一件事
  
• 線（wire） —— 把節點接起來，資料從左邊流到右邊
  
• 流程（flow） —— 一整組接起來的節點，也是上方分頁的一頁
  

在節點之間流動的東西叫訊息（msg），它是一包資料，最常用的欄位是 msg.payload（主要內容）和 msg.topic（標記這則訊息是誰送的）。

對照 Home Assistant 的自動化：

1. HA 自動化            Node-RED
2. ------------------   ---------------------------
3. triggers（觸發）     Events: state 節點
4. conditions（條件）   Switch 節點
5. actions（動作）      Action 節點

複製代碼

⚠ 最後一行是這篇最重要的更正。網路上幾乎所有 Node-RED 教學都寫「call service 節點」。Home Assistant 在 2024.8 把 service call 正名為 action，節點包跟著改名，現在面板上那個藍色方塊叫「action」，搜尋 "call service" 會一個都找不到。

好消息是舊流程不會壞：節點的內部型別仍是 `api-call-service`，別人幾年前匯出的 JSON 照樣匯得進來，只是顯示成 Action。

什麼時候值得開 Node-RED

• 邏輯有三層以上的分支，YAML 的 choose 已經看不懂
  
• 要做「持續 N 分鐘」「每 N 分鐘最多一次」這種時間控制
  
• 要串外部 API、資料庫、Telegram
  
• 你看圖比看文字快
  

不值得的情況也講清楚：「A 發生就做 B」用 HA 的 UI 點三下就好，為了這個多養一個服務（大約 200～400 MB 記憶體）不划算。實務上多數人兩邊都用：簡單的留在 HA，複雜的搬進 Node-RED。



步驟 1：先確認你的主機裝得起來

Node-RED 應用程式（以前叫附加元件）現在只提供 aarch64 與 amd64 兩種架構。

• 樹莓派 3/4/5 跑 64 位元 HA OS —— 可以
  
• x86 迷你主機 / NUC / 虛擬機 —— 可以
  
• 32 位元系統（armv7、舊的樹莓派映像）—— 商店裡根本不會出現這個項目
  

你會看到什麼：在商店裡搜尋 Node-RED，如果架構不合，它不會顯示「不支援」，而是整個項目不出現。找不到的時候先去「設定 → 系統 → 系統資訊」看 CPU 架構，不要以為是商店壞了。

步驟 2：安裝

路線 A：Home Assistant 應用程式（推薦，也是這篇後面用的）

• 設定 → 應用程式 → 右下角應用程式商店
  

⚠ 選單名稱在 2026.2 改過：舊教學寫的「附加元件（Add-ons）」現在叫「應用程式（Apps）」。功能一模一樣，只是名字和路徑變了，所有舊教學的截圖都對不上。

以下還有約 81% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入