HomeKit Bridge 完整設定：把 Home Assistant 的裝置送進「家庭」App

charles

這篇的內容（11 段）

1. 這一篇做完你會有什麼
2. 0-3 版本
3. 怎麼看這個數字
4. 步驟 2：建立 HomeKit Bridge
5. 步驟 3：用 iPhone 配對
6. 步驟 4：驗證它真的是雙向的
7. 步驟 5：配對失敗的逐項排查
8. 5-2 卡在「正在加入配件」不動
9. 5-4 配件數超過 150
10. 怎麼確認
11. 通過這一篇的標準

Home Assistant 控制得了的東西，不管原廠支不支援 HomeKit，都可以變成 iPhone「家庭」App 裡的一個配件。這一篇把整個過程從頭做完：前提怎麼確認、橋接怎麼建、配對失敗時怎麼一層一層排查，以及 2026 年冷氣配件長相改掉之後會看到什麼。



這一篇做完你會有什麼

• 「家庭」App 裡多出一批配件，來源是 Home Assistant，不是原廠 App
  
• 家人用 Siri 或鎖定畫面就控制得了，不需要學 Home Assistant
  
• 一套可以照著跑的排查流程 —— 配對失敗是這個整合最常見的狀況，而失敗訊息本身幾乎沒有資訊
  

先講清楚分工，因為它決定你等一下要橋接哪些東西

• 判斷邏輯放 Home Assistant：多重條件、數值比較、時間推算、歷史紀錄、有內容的通知
  
• 操作介面放「家庭」App：開關、亮度、場景，家人按一下就好
  
• 同一件事只准在一邊寫自動化，另一邊只當介面。兩邊都寫會互相觸發，症狀是燈連續閃爍
  

所以要橋接的是「家人會想動手操作的東西」，不是全部實體。這一點在步驟 1 會變成具體的數字。

步驟 0：確認三個前提，缺一個後面每一步都會失敗

0-1 你必須有一台合格的家庭中樞

這一點在 2026 年變了，而且變得很硬：Apple 舊版家庭架構已於 2026 年 2 月 10 日停止支援，新架構把自動化與狀態維護搬到常駐的中樞上，iPad 不再算是家庭中樞。

現在合格的只有三種：

• HomePod（第 2 代）或 HomePod mini —— 設定完成就自動成為中樞，不用另外開
  
• Apple TV（第 4 代以後的機種）—— 要到 設定 → AirPlay 與 Apple 家庭 → 房間，指定一個房間之後才會變成中樞
  
• 舊版家庭架構下曾經被當成中樞的 iPad，現在只能當遙控器
  

怎麼確認：iPhone 開「家庭」App → 左上角房子圖示 → 家庭設定 → 家庭中樞與橋接器。

你會看到：最上面一台標著「已連線」，下面可能列出其他備援中樞。

這一頁是空的、或每一台都寫「無回應」 → 你沒有可用的中樞。這種狀態下就算橋接成功，遠端控制、自動化、推播通知全部不會動，只有在家連同一個 Wi-Fi 時能手動開關。先把中樞處理好再往下走。

0-2 iPhone 與 Home Assistant 要在同一個網段

HomeKit 的裝置探索走 mDNS（多播），多播預設不會跨越 VLAN 與網段。

• iPhone 連的 Wi-Fi 與 Home Assistant 主機在同一個 IP 網段（例如都是 192.168.1.x）
  
• 路由器的「AP 隔離」「用戶端隔離」要關掉
  
• 訪客網路不行
  

0-3 版本

Home Assistant 目前穩定版是 2026.9.3。iPhone 至少要 iOS 16.2（新家庭架構的最低需求），但下面用到的幾個選單名稱是以近兩年的版本為準。

步驟 1：先算出你要橋接幾個實體

HomeKit 協定規格上限是一座橋 150 個配件。 這不是 Home Assistant 的限制，是 Apple 那邊的規格，超過就是配對失敗，而且失敗訊息不會告訴你原因。

先算清楚，不要等配對失敗才回頭猜。

到 開發者工具 → 範本，把左邊整個清空，貼上這一段：

1. 燈 light:      {{ states.light | list | count }}
2. 開關 switch:   {{ states.switch | list | count }}
3. 冷氣 climate:  {{ states.climate | list | count }}
4. 風扇 fan:      {{ states.fan | list | count }}
5. 窗簾 cover:    {{ states.cover | list | count }}
6. 鎖 lock:       {{ states.lock | list | count }}
7. 感測器 sensor: {{ states.sensor | list | count }}
8. 二元感測器:    {{ states.binary_sensor | list | count }}
9. 媒體 media:    {{ states.media_player | list | count }}
10. 場景 scene:    {{ states.scene | list | count }}
12. 合計: {{ (states.light | list | count)
13.         + (states.switch | list | count)
14.         + (states.climate | list | count)
15.         + (states.fan | list | count)
16.         + (states.cover | list | count)
17.         + (states.lock | list | count) }}

複製代碼

你會看到：右邊即時算出每一類的數量，不用按任何按鈕。

右邊出現紅字 TemplateSyntaxError → 複製時少了一個大括號。整段重貼一次。

怎麼看這個數字

• 合計低於 120 → 一座橋就夠，直接往下做
  
• 120 到 150 → 勉強夠，但之後新增裝置就會撞上限。建議現在就只挑家人會用的
  
• 超過 150 → 一定要用「排除」的方式縮小範圍，或是開第二座橋
  

sensor 和 binary_sensor 通常是最大宗（每支手機的電量、每個裝置的連線狀態都算一個），而這些在「家庭」App 裡幾乎沒有用。步驟 2 勾選時把這兩類整個排掉，數字立刻少一大半。

步驟 2：建立 HomeKit Bridge

• 設定 → 裝置與服務
  
• 右下角新增整合
  
• 搜尋 HomeKit Bridge（不是 HomeKit Device，那個方向相反，是把 HomeKit 裝置拉進 Home Assistant）
  
• 第一頁問模式，選 Bridge（橋接）
  
• 第二頁勾要包含哪些網域。建議只勾 light、switch、climate、fan、cover、lock、scene
  
• 第三頁可以逐一取消個別實體
  
• 送出
  

你會看到：左上角的通知圖示冒出一則新的，標題是 HomeKit Bridge 之類的字樣，內容是一張 QR 圖和一組八位數的 PIN，格式像 123-45-678。

通知沒有出現 → 到 設定 → 系統 → 日誌 看有沒有 homekit 開頭的紅字。最常見的是埠被占用（訊息裡會有 Address already in use），這代表你已經有一座橋在跑了。

步驟 3：用 iPhone 配對

配對的時候人要在家，手機要連家裡的 Wi-Fi，不能用行動網路。

• 開「家庭」App → 右上角加號 → 加入配件
  
• 鏡頭對準 Home Assistant 通知裡那張 QR。掃不到的話按下方的更多選項，手動輸入那八位數字
  
• 出現「未認證的配件」警告 —— 這是正常的，Home Assistant 沒有付錢做 Apple 的認證。按仍要加入
  
• 接著會問每一個配件放在哪個房間、叫什麼名字。數量多的話這一段要按很久
  

你會看到：全部指定完之後，「家庭」App 的首頁一次多出一批配件磚，而 Home Assistant 那則含 QR 的通知會自己消失。

通知沒消失、但配件已經出現 → 重新整理一次 Home Assistant 的頁面。通知是快取的。

步驟 4：驗證它真的是雙向的

不要只看配件有沒有出現，要看兩個方向都通：

• 家庭 App 往 Home Assistant：在「家庭」App 點一盞燈開啟。回到 Home Assistant，設定 → 系統 → 日誌記錄（logbook），你會看到一秒內出現一筆「燈 被 HomeKit Bridge 開啟」
  
• Home Assistant 往家庭 App：在 Home Assistant 的儀表板把同一盞燈關掉。回到 iPhone，你會看到那張配件磚兩三秒內自己變成關閉狀態
  

只有一個方向會動：

• 家庭 App 按了沒反應，Home Assistant 也沒紀錄 → iPhone 連不到 Home Assistant 的 21063 埠，回步驟 5-1
  
• Home Assistant 改了，家庭 App 不跟著變 → 這是 mDNS 單向通、但狀態推播回不去，同樣是步驟 5-1 的問題
  

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

登入繼續閱讀使用 Google 登入