全家都用 iPhone：把 Home Assistant 的裝置送進「家庭」App 的完整設定

charles

這篇的內容（12 段）

1. 先把前提更正
2. 這篇會做完什麼
3. 第零步：先確認網路條件
4. 第一步：把 Home Assistant 裝起來
5. 第三步：開啟 HomeKit Bridge
6. 第四步：配對
7. 第六步：驗證橋接真的在運作
8. 測試一：從家庭 App 控制
9. 測試二：從 Home Assistant 控制
10. 測試三：Siri
11. 第七步：處理 150 個配件上限
12. 第十步：故障排除

先更正一個很多人還在講的說法：「要進『家庭』App，裝置一定要有 HomeKit 認證」—— 這句話在 Matter 出現之後已經不對了。現在有兩條合法路徑，而這改變了「還需不需要 Home Assistant」的答案。這篇把正確的前提講清楚，然後把 HomeKit Bridge 從零設定到家人無感為止。



先把前提更正

一台裝置要出現在 iPhone 的「家庭」App 裡，今天有兩條路：

• 傳統的 HomeKit 路線：廠商加入 Apple 的 MFi 計畫、送測、通過之後才能掛「Works with Apple Home」徽章。2017 年之後那顆認證晶片可以用軟體認證取代，但要上市販售仍然要走 MFi
  
• Matter 路線：廠商把產品送 CSA（Connectivity Standards Alliance）做 Matter 認證，完全不必加入 MFi。通過之後一樣進得了家庭 App，也一樣有對應的徽章規範
  

所以「HomeKit 裝置貴一倍是因為認證成本」這個論點，在 2026 年已經不是主要因素了。Matter 打開了第二條門，價格差距也跟著收斂。

那為什麼還會需要 Home Assistant？ 理由換成三個，而且這三個都不會因為 Matter 普及而消失：

• 理由一：家庭 App 支援的 Matter 型別清單很窄。 Apple 官方支援文件列出來的是：空調、橋接器、燈、門鎖、插座、開關、恆溫器、窗簾遮陽、以及感測器（移動、環境光、門窗、溫度、濕度）。清單以外的東西，就算它是通過認證的 Matter 裝置，家庭 App 也不會顯示它 —— 攝影機、電視、掃地機器人、洗衣機、空氣品質感測器、功率量測、水位偵測，全都不在
  
• 理由二：你家一定有不是 Matter 的東西。 Zigbee 感應器、Z-Wave 門鎖、只有雲端 API 的除濕機、你自己用 ESP32 做的那個東西 —— 它們永遠不會變成 Matter 裝置
  
• 理由三（最不會過期的一個）：Home Assistant 可以把「算出來的東西」變成家庭 App 裡的配件。 「全家都不在家」不是一台裝置，「洗衣機跑完了」不是一台裝置，「濕度超過 70% 而且窗戶是關的」也不是。這些是 Home Assistant 算出來的狀態，而 HomeKit Bridge 可以把它們包裝成一個開關或感應器送進家庭 App。任何實體裝置都做不到這件事
  

理由三就是整篇的重點。下面第八步會做一個實際的例子。

這篇會做完什麼

• 把 HomeKit Bridge 開起來並配對成功
  
• 用 YAML 精確控制要送哪些實體過去（不是全部丟進去）
  
• 把一個 Home Assistant 算出來的狀態，變成家庭 App 裡可以按的配件
  
• 處理 150 個配件上限
  
• 決定哪些自動化寫在 HomeKit、哪些寫在 Home Assistant
  

第零步：先確認網路條件

HomeKit 靠 mDNS（Bonjour）在區域網路上發現配件。這一步沒過，後面全部會卡在「找不到配件」。

三個條件：

• iPhone 和 Home Assistant 主機要在同一個區域網路、同一個 VLAN。跨 VLAN 的話 mDNS 預設不會通過，要在路由器上開 mDNS repeater（reflector）
  
• 無線 AP 不能開「用戶端隔離」（AP isolation / client isolation）。開著的話同一個 Wi-Fi 底下的裝置彼此看不見
  
• 防火牆要放行 UDP 5353（mDNS）與 TCP 21063（HomeKit Bridge 的預設埠）
  

Docker 安裝的特別注意：Home Assistant 跑在 Docker 的 bridge 網路模式下時，mDNS 出不去。兩個選項：

• 在 docker-compose.yml 裡設 network_mode: host（最簡單，多數人選這個）
  
• 或者保留隔離網路，在設定裡指定 advertise_ip，並且在主機上跑一個 mDNS 轉發器（例如 avahi-daemon）
  

你會看到什麼：要確認 mDNS 通不通，在和 iPhone 同一個 Wi-Fi 的電腦上執行：

1. # macOS / Linux
2. dns-sd -B _hap._tcp
4. # 或者
5. avahi-browse -rt _hap._tcp

複製代碼

正常會列出你家所有的 HomeKit 配件（包含 Apple TV、HomePod）。完全沒有輸出代表 mDNS 在這個網段上不通，先解決這個再往下走。

第一步：把 Home Assistant 裝起來

如果你已經有 Home Assistant 在跑，跳到第二步。

買什麼：

• 最省事：Home Assistant Green（官方現成機，插電接網路線就好）。2026 年價格因為記憶體漲價上調過，實際售價請以官方商店為準
  
• 最划算：二手或新的 N100 迷你主機。2026 年樹莓派 5 因為 DRAM 漲價，「樹莓派最划算」這個舊結論已經反過來，N100 通常比較便宜而且快很多
  
• 已經有 NAS 或一台常開的電腦：直接跑 Docker 版
  

安裝方式只剩兩種是官方支援的：Home Assistant OS 與 Container。Supervised 與 Core 這兩種安裝方式官方已在 2025-05-22 公告棄用、2025.12 結束支援，官方安裝頁已經把它們移除了。舊教學裡的 Supervised 安裝腳本不要再用。

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

登入繼續閱讀使用 Google 登入