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

charles · 發表於 2026-9-21 01:46:54

這篇的內容（5 段）

1-1 查 HA 主機的 IP
1-2 查 iPhone 的 IP
1-3 比對
1-4 測 mDNS 有沒有通
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 位址」那一區。

你會看到類似：

eth0 192.168.1.50/24
閘道 192.168.1.1

複製代碼

1-2 查 iPhone 的 IP

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

你會看到：

IP 位址 192.168.1.87
子網路遮罩 255.255.255.0
路由器 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 附加元件裡）執行：

ping -c 3 homeassistant.local

複製代碼

你會看到：

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

複製代碼

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

路由器開了 AP 隔離 或 用戶端隔離（Client Isolation）—— 進路由器設定找這幾個字，關掉
路由器的 IGMP Snooping 設定不當，把群播封包吃掉了 —— 試著關掉看看
你用的是 Mesh 系統或多台 AP，而 iPhone 跟 HA 連在不同台 —— 暫時把兩者連到同一台測試

1-5 如果 HA 跑在 Docker 裡

Docker 的預設 bridge 網路收不到 mDNS 廣播。兩個解法：

改用 host 網路模式（推薦）—— docker run 加上 --network host，或 compose 裡寫 network_mode: host。這是最簡單也最可靠的
保留 bridge 網路 —— 那就必須在 HomeKit 的設定裡填 advertise_ip（填主機的實體 IP），並且在主機上跑一個 avahi-daemon 的反射（reflector）模式把廣播轉進去。步驟多、故障點也多

■ 步驟 2：用圖形介面新增 HomeKit Bridge

大多數人用這條就夠了。

到 設定 → 裝置與服務 → 新增整合
搜尋 HomeKit Bridge（不是那個叫 HomeKit Device 的 —— 那是反過來，把 HomeKit 裝置接進 HA。兩個名字很像，選錯的人非常多）
點它，你會看到一個對話框問你要包含哪些種類

對話框裡是一個多選的下拉：

要包含的種類
[ ] alarm_control_panel [ ] binary_sensor
[ ] camera [v] climate
[ ] cover [ ] fan
[ ] humidifier [v] light
[ ] lock [ ] media_player
[ ] remote [ ] sensor
[v] switch [ ] vacuum
[ ] water_heater

複製代碼

第一次只勾 light 和 switch 兩個就好。 理由不是保守，是可除錯性：配對失敗時，如果你一次丟了兩百個實體進去，你不會知道是網路問題還是某一個實體讓 bridge 起不來。先用兩三個裝置確認整條路是通的，再往上加。

按「送出」之後，下一頁會問你要不要細選實體。選 「包含全部」（等一下會用 YAML 精修），然後按「完成」。

你會看到整合清單裡多出一張 HomeKit Bridge 的卡片，下面寫著「1 個服務」。

同時，HA 畫面右上角的鈴鐺會出現一個紅點。點開它 —— 配對碼在那裡。

你會看到一則通知，內容是一個 QR code 加上一串八位數字：

HomeKit Bridge 設定
請掃描下方的 QR code，或手動輸入配對碼：
123-45-678

複製代碼

鈴鐺裡沒有這則通知 → bridge 沒有啟動成功。到 設定 → 系統 → 日誌，搜尋 homekit，會有具體原因（最常見是 21063 埠被佔用）。

■ 步驟 3：在 iPhone 上配對

iPhone 打開 「家庭」 App
右上角 + → 「加入配件」
把相機對準 HA 通知裡的那個 QR code

你會看到這個順序：

螢幕出現 「在網路上找到配件」，下面是一個叫 Home Assistant Bridge 的項目
點它之後出現 「這是未認證的配件」 的警告 —— 按「仍要加入」，這是正常的。HA 沒有去申請蘋果的 MFi 認證，所有自架的 bridge 都會有這個警告
接著它會一個一個問你每個裝置要放哪個房間、叫什麼名字

全部走完之後，你會看到「家庭」App 的首頁出現你在步驟 2 勾選的那些燈和開關。

測試：在「家庭」App 裡點一盞燈。

你會看到：

燈真的亮
回到 HA，設定 → 日誌簿 裡那盞燈有一筆紀錄，觸發者顯示為 HASS Bridge 或 HomeKit

日誌簿那一筆是關鍵證據 —— 有它就代表整條鏈路（iPhone → mDNS → HA → 裝置）全部通了。

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

登入繼續閱讀使用 Google 登入

		自動登入	找回密碼
密碼			立即註冊

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

延伸閱讀