不支援 HomeKit 的裝置也能進 iPhone「家庭」App：HomeKit Bridge 完整設定

charles

這篇的內容（5 段）

1. 1-1 查 HA 主機的 IP
2. 1-2 查 iPhone 的 IP
3. 1-3 比對
4. 1-4 測 mDNS 有沒有通
5. 1-5 如果 HA 跑在 Docker 裡

小米插座、Tuya 燈泡、Zigbee 感應器、自己用 ESPHome 做的東西 —— 只要 Home Assistant 控制得了，就能出現在 iPhone 的「家庭」App 裡，而且不用多買任何硬體。這一篇把整個流程從網路檢查寫到疑難排解，照著做一遍就會了。



■ 原理與限制（三十秒讀完，但兩個數字要記住）

HA 有一個叫 HomeKit Bridge 的內建整合，它會讓 HA 把自己偽裝成一台 HomeKit 橋接器，透過 mDNS 在區域網路上廣播。iPhone 掃到之後，就把它當成一台真的 HomeKit 配件來配對。

兩個一定要先知道的數字：

• 一個 bridge 最多 150 個配件 —— 這是 HomeKit Accessory Protocol 規格本身的限制，不是 HA 的限制。超過的話整個 bridge 會出問題，而不是只有多出來的那幾個不見
  
• 預設用 TCP 21063 這個埠，加上 UDP 5353（mDNS） —— 兩個都要通，少一個就配不上
  

還有一個「配件」跟「實體」的換算要注意：一個實體通常等於一個配件，但不一定。像會顯示溫度又顯示濕度的感測器，在 HomeKit 眼中是兩個服務。所以抓 150 這個數字時要留一點餘裕，抓到 120 左右比較安全。

■ 步驟 1：先確認網路（這一步不做，後面 80% 的人會卡住）

HomeKit 的配對完全靠 mDNS 廣播，而 mDNS 廣播不會跨網段。所以第一件事是確認 iPhone 跟 HA 主機在同一個地方。

1-1 查 HA 主機的 IP

到 設定 → 系統 → 網路，往下捲到「IP 位址」那一區。

你會看到類似：

1. eth0     192.168.1.50/24
2.          閘道 192.168.1.1

複製代碼

1-2 查 iPhone 的 IP

iPhone 上：設定 → Wi-Fi → 點目前連線右邊的圓圈 i。

你會看到：

1. IP 位址      192.168.1.87
2. 子網路遮罩    255.255.255.0
3. 路由器        192.168.1.1

複製代碼

1-3 比對

• 兩邊前三段一樣（192.168.1.x）而且路由器 IP 一樣 → 同一個網段，可以繼續
  
• 前三段不一樣（例如 HA 在 192.168.1.50、iPhone 在 192.168.50.87）→ 不同網段，配對一定失敗。最常見的原因是 iPhone 連到了訪客網路，或你家有兩台路由器串接。先把 iPhone 換到跟 HA 同一個 Wi-Fi
  

1-4 測 mDNS 有沒有通

在 Mac 上（或 HA 的 Terminal 附加元件裡）執行：

1. ping -c 3 homeassistant.local

複製代碼

你會看到：

1. PING homeassistant.local (192.168.1.50): 56 data bytes
2. 64 bytes from 192.168.1.50: icmp_seq=0 ttl=64 time=2.431 ms
3. 64 bytes from 192.168.1.50: icmp_seq=1 ttl=64 time=1.882 ms
4. 64 bytes from 192.168.1.50: icmp_seq=2 ttl=64 time=2.104 ms

複製代碼

印出 cannot resolve homeassistant.local → mDNS 在你家的網路上不通。三個常見原因，按順序查：

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

登入繼續閱讀使用 Google 登入