A LITTLE CORNER OF MY WORLD

讀一段文字,留一點時光

認真記錄的每個瞬間,都有自己的光。

返回所有文章
跨區折騰

Home Assistant 入門:把大陸買的設備接進 Apple HomeKit 全教程

人在海外,家裡一堆米家、Aqara、塗鴉設備,想用 iPhone 和 Siri 統一控制?這篇從硬件選購、安裝到米家、Aqara、塗鴉接入,再到橋接 HomeKit,一步步講清楚。

文章目錄
  1. Home Assistant 是什麼,能解決什麼
  2. 需要什麼硬件
  3. 安裝:首選 Home Assistant OS
  4. 接入米家設備:走官方集成
  5. 接入 Aqara 設備:兩條路線
  6. 接入塗鴉設備:官方集成最省事
  7. 橋接到 HomeKit:最後一步
  8. 常見坑:先知道,再動手
  9. 一句話總結
  10. 參考來源

Home Assistant 入門:把大陸買的設備接進 Apple HomeKit 全教程

人在海外,家裡還留著一堆大陸買的智能設備:米家的傳感器、Aqara 的開關、塗鴉的燈。手機裡三個 App 輪著開,Siri 一個都叫不動。想把它們收進 Apple HomeKit,用 iPhone 和 Siri 統一控制,這就是 Home Assistant 最擅長的活。

這篇教程的目標很具體:不講 Home Assistant 的全部玩法,只講一條線——從零搭一個 Home Assistant,把大陸買的米家、Aqara、塗鴉設備接進來,再橋接到 HomeKit。價格按 2026 年 11 月採集的行情,買之前以頁面實時價為準。

Home Assistant 是什麼,能解決什麼

Home Assistant(簡稱 HA)是一個開源的智能家居中樞軟件,跑在你自己家裡的硬件上。它最大的特點是協議和品牌來者不拒:Zigbee、Wi-Fi、藍牙、Matter、Thread 都能接,米家、Aqara、塗鴉、美的這些大陸生態的設備也能接進來,再統一暴露給 Apple HomeKit。

對海外華人來說,它解決的是三個具體問題:

  • 一個入口:米家、Aqara Home、塗鴉智能三個 App 合併成一個面板,再進 HomeKit。
  • 跨區:很多大陸設備的雲端有地區限制,但 Home Assistant 走本地局域網控制,設備只要在同一個局域網裡就能管,不經過大陸服務器。
  • 斷網可用:本地自動化不依賴雲端,寬帶斷了,家裡的燈和傳感器聯動照常跑。

代價也很明確:你要自己準備一臺 24 小時開機的硬件,裝系統、裝集成,遇到問題要自己查。接受這個代價,再往下看。

需要什麼硬件

Home Assistant 必須跑在一臺長期開機的設備上。下面四種是 2026 年最常見的方案,按省事程度排序。

方案 大概價格(2026 年 11 月) 優點 缺點 適合誰
Home Assistant Green 官方盒子 官網 199 美元,國內 DFRobot 約 1299 元 插電聯網就能用,零安裝 性能一般,不能擴內存和存儲 完全不想折騰的人
樹莓派 5 單板 4GB/8GB 約 400–700 元,成套更貴 功耗低、體積小、教程最多 性能有限,SD 卡容易壞,建議上 SSD 新手、設備 30 臺以內
N100 迷你主機 全新整機約 600–1000 多元,二手準系統裸機約 450–850 元 性能強幾倍,能跑更多服務 待機功耗比樹莓派高 設備多、想跑複雜自動化
已有的綠聯 NAS 綠聯 DX4600 8G 空盤版京東約 1450 元 不用多買一臺設備 需要虛擬機安裝,佔用 NAS 資源 家裡已經有 NAS 的人

幾點補充說明:

  • Home Assistant Green 是官方在 2023 年推出的成品盒子,預裝了系統,插上電源和網線就能用。官方建議零售價 199 美元,2026 年因為元器件漲價從 99 美元一路漲上來。國內沒有官方直營,淘寶和 DFRobot 這類創客商城能買到,價格約 1299 元。
  • 樹莓派是最經典的方案。官方要求樹莓派 4 或 5,最低 2GB 內存。社區的普遍建議是樹莓派 4(4GB)是底線,樹莓派 5 是現在的推薦標準。2026 年樹莓派價格漲了不少,有值友提到成套價格漲到 1600 元,買單板自己配電源和散熱更划算。
  • N100 迷你主機是 2026 年性價比最高的路線。一臺 N100 迷你主機待機功耗 8–12W,一年耗電約 88 度,電費約 53 元。性能比樹莓派強好幾倍,重啟只要幾十秒,還能順手跑其他服務。二手市場有很多拆機準系統,450 元左右能淘到裸機,但要自己加內存和硬盤。
  • 綠聯 NAS(比如 DX4600)適合家裡已經有 NAS 的人。在 NAS 裡開虛擬機裝 Home Assistant OS,插件商店完整可用;如果只用 Docker 裝,插件商店是沒有的,這一點買之前要分清。

不管選哪種,記住一條:Home Assistant 要 24 小時開機,別拿每天關機的電腦湊合。

安裝:首選 Home Assistant OS

Home Assistant 有幾種安裝方式,新手只記一種:Home Assistant OS(HAOS)。這是官方系統,自帶插件商店和一鍵升級,最省心。

以樹莓派為例,步驟是:

  1. 在電腦上裝 Raspberry Pi Imager,選樹莓派型號,在系統列表裡選 Home Assistant OS,寫入 microSD 卡(寫入會清空整張卡)。
  2. 把卡插進樹莓派,接上網線和電源,等幾分鐘首次啟動。
  3. 在同一局域網的電腦或手機瀏覽器打開 homeassistant.local:8123,按嚮導創建本地賬號。

N100 迷你主機也一樣:把 HAOS 鏡像寫到內置 SSD 上,開機就能用。綠聯 NAS 則是先在 App 中心裝“虛擬機”,再在虛擬機裡裝 HAOS。

Docker 方式也可以跑,但沒有插件商店,後面要裝的很多集成會麻煩不少。新手別走這條路。

裝好之後先做兩件事:設置一個固定 IP(在路由器裡給 HA 綁定地址,免得重啟後地址變了找不到),以及做一次備份(設置裡有備份功能,備份文件存到電腦上)。

接入米家設備:走官方集成

米家設備現在有了官方集成,接入比以前簡單得多。集成地址是 github.com/XiaoMi/ha_xiaomi_home,由小米官方維護。

步驟:

  1. 先裝 HACS(Home Assistant 社區商店)。在 HACS 界面點右上角三個點,選“自定義軟件源”,填入米家集成的地址,類型選“集成”,點添加。
  2. 在 HACS 裡搜索 Xiaomi Home,下載,重啟 Home Assistant。
  3. 去“設置 > 設備與服務”,添加 Xiaomi Home 集成,按提示用米家賬號登錄。
  4. 登錄後,米家賬號下的設備會出現在設備列表裡。

注意兩個限制:第一,這個集成目前還沒有進 HACS 官方收錄,必須用自定義軟件源的方式添加;第二,米家賬號本身有地區概念,設備要先在米家 App 裡配好網,集成讀的是你賬號下的設備,賬號地區和設備版本要對得上,混著用會出問題。

接入 Aqara 設備:兩條路線

Aqara 設備有兩條進 Home Assistant 的路線,按設備類型選:

路線一:網關走 HomeKit 直連。 Aqara 的網關(比如 M1S、M3)本身支持 HomeKit,網關下的 Zigbee 子設備會跟著網關一起進 HomeKit。把網關先加進 Aqara Home App,再用 Home Assistant 的 HomeKit Device 集成配對網關,子設備就都進來了。優點是簡單,缺點是網關本身有地區限制,國行網關只能連大陸服務器,人在海外用國行網關要先看鎖區問題(見本站《Aqara / 米家海外版鎖區怎麼辦》)。

路線二:Zigbee 設備直連 Home Assistant。 不用 Aqara 網關,直接給 Home Assistant 插一個 Zigbee 協調器(比如 SONOFF ZBDongle-P,官網 19.9 美元,亞馬遜約 24.9 美元),用 Zigbee2MQTT 或 ZHA 把 Aqara 的 Zigbee 開關、傳感器一個個配對進來。這條路線完全繞開 Aqara 的雲和服務器,鎖區問題不存在,但配對和調試要自己動手。

帶 Wi-Fi 的 Aqara 設備(比如人體存在傳感器 FP2、門鈴 G4、攝像頭網關 G3)還有第三種接法:它們本身支持 HomeKit 協議,Home Assistant 可以用內置的 HomeKit Device 集成直接配對。注意配對前要先把設備從 Apple 家庭 App 裡移除(一個 HomeKit 設備同一時間只能配對一個控制器),並且設備和 Home Assistant 要在同一個局域網裡。

接入塗鴉設備:官方集成最省事

塗鴉(Tuya)設備走官方 Tuya 集成,是目前最省事的路線:

  1. 手機上先裝塗鴉智能或智能生活 App,註冊賬號並把設備配好網。
  2. Home Assistant 要 Core 2024.2.0 或更高版本。去“設置 > 設備與服務”,添加 Tuya 集成。
  3. 集成會要求填一個“用戶代碼”:在塗鴉 App 裡點“我的 > 設置 > 賬號與安全 > 用戶 Code”就能找到。
  4. 填完用戶代碼後,用 App 掃碼登錄,設備就同步過來了。

塗鴉的 Zigbee 設備也可以不走塗鴉網關,直接用上面說的 Zigbee 協調器 + Zigbee2MQTT 接進來,效果和 Aqara 的 Zigbee 設備一樣,脫離塗鴉雲端。這兩種方式選一種就行,別兩邊同時接,同一個設備在兩個地方會出現狀態打架。

橋接到 HomeKit:最後一步

設備都進了 Home Assistant,接下來把它們橋接到 Apple HomeKit:

  1. 去“設置 > 設備與服務”,添加集成,搜索 HomeKit Bridge。
  2. 按嚮導選要暴露給 HomeKit 的設備類型(燈、開關、傳感器、窗簾等),不選的就不會出現在家庭 App 裡。
  3. 添加完成後,Home Assistant 會生成一個 HomeKit 配對碼,打開 iPhone 的家庭 App,點右上角 +,掃碼添加。
  4. 添加後就能在家庭 App 裡看到設備,用 Siri 控制。

兩個要點:

  • 家庭中樞:想在外面遠程控制、想跑自動化,必須家裡有一個 HomePod、HomePod mini 或 Apple TV 做家庭中樞。這是蘋果的要求,跟 Home Assistant 無關。
  • 不是所有設備都能過橋:攝像頭、門鎖這類設備過橋有限制,有些實體類型 HomeKit 不支持,橋接時會直接跳過。燈、開關、插座、傳感器、窗簾這些是最穩的。

常見坑:先知道,再動手

  • 局域網問題:Home Assistant 發現設備靠 mDNS,設備和 Home Assistant 必須在同一個局域網。如果家裡分了 2.4G 和 5G 兩個 Wi-Fi,或者 IoT 設備單獨一個 VLAN,配對會失敗。配網時手機、設備、Home Assistant 都先放到同一個 2.4G 網絡裡,配好再說。
  • 2.4G 還是 5G:絕大多數智能家居設備只支持 2.4G Wi-Fi。配網時手機必須連 2.4G,5G 下配網會一直轉圈。
  • 賬號地區:米家和 Aqara 的賬號、設備、服務器三者要對應。國行設備配國行賬號、大陸服務器,海外版設備配海外賬號、海外服務器,混著用輕則部分功能沒有,重則設備加不進來。
  • 插件失效:HACS 裡的第三方集成是社區維護的,Home Assistant 大版本升級後偶爾會失效。升級前先看一眼更新日誌,升級後第一時間檢查設備在不在線。重要的自動化先備份。
  • 別把 8123 端口直接暴露到公網:想在外面訪問 Home Assistant,用官方的 Home Assistant Cloud,或者自己搭 WireGuard、Tailscale 這類 VPN。直接把端口映射到公網等於把家門鑰匙掛在門口。

一句話總結

人在海外想把大陸買的設備收進 HomeKit,最穩的路線是:一臺 N100 迷你主機或樹莓派裝 Home Assistant OS,米家走官方集成,Aqara 的 Zigbee 設備用協調器直連,塗鴉走官方 Tuya 集成,最後用 HomeKit Bridge 一次性橋接到家庭 App。硬件花 600–1500 元,一個週末能搭完,搭完之後米家、Aqara、塗鴉三個 App 基本可以刪了。

參考來源

✿

感謝讀到這裡,願這些文字對你有所幫助。

華人智能家居指南
華人智能家居指南 / smart-home-zh

寫一點代碼,記錄一點生活。