利用 Synology NAS 搭建 HomeBridge，讓小米家電也能支援 Homekit，用 Siri 就能控制

想用 Siri 語音控制小米家電，最快的方法是利用 Synology NAS 安裝 HomeBridge 橋接器。透過 Docker 建立環境並安裝對應外掛，就能輕鬆整合至 Apple HomeKit。

雖然 APPLE 推出 Homekit 這個服務也有段時間，不過因為支援的家電太少，很多人還不會注意到，反觀小米家電的 APP 連動就做的很好，但如果想要語音控制要買台灣未上市的小愛同學或其它設備。阿湯最近研究了一下，透過家中的 Synology NAS 搭建了一個 HomeBridge 橋接器，讓小米的家電也能透過這個橋接器加入到 APPLE 的 Homekit 裡，就能進一步的透過 Siri 語音直接控制，目前實測了小米檯燈、小米掃地機器人以及電風扇都完美的整合了，有興趣研究的可以參考一下阿湯的做法。

在往下看要怎麼做之前先給大家看一下，這是我的 Homekit APP 畫面，目前結合了三個小米設備，而且能讓 Siri 語音控制這些設備的開關或更多操作，有興趣研究就往下來看吧。

在 Synology NAS 安裝 HomeBridge 橋接器的完整步驟

要在 Synology NAS 上搭建 HomeBridge，需先透過套件中心安裝 Docker，接著手動安裝網友打包好的 Homebridge SPK 檔案即可完成基礎環境建置。

要搭建 HomeBridge 有很多種做法，除了阿湯今天要分享的 Synology NAS 之外，你也可以透過家中的 APPLE 電腦（iMac、Macbook 等），或者網路上可以搜一下樹莓派，但如果有 Synology NAS 會方便很多，因為已經有網友寫好的腳本簡化不少，有興趣的朋友先想想，因為搭建很簡單，但要讓小米家電加入 Homekit 有點麻煩，可以先看完再決定。

1. 安裝 Docker：首先登入到你的 NAS，在套件中心搜尋 docker，然後點擊安裝套件。原則上我們就是透過 Docker 的方式來運行，不過我們只需要將 Docker 安裝好，不需要進去特別設定什麼。

1. 下載並手動安裝 Homebridge 套件：接下來就下載強大網友已經做好的 Homebridge 套件，可以在網頁上看最新的版本下載，目前是 1.0.7。
   • HomebridgeDocker 套件頁面：請點我
   然後在套件中心右上角點擊「手動安裝」後，選擇我們下載的 SPK 檔案，按下一步進行安裝。

1. 安裝精靈確認：安裝過程都不太需要選擇，直接點擊下一步。

1. 套件資訊確認：確認無誤後，再按下一步。

1. 啟用圖形化介面：這邊是問你要不要有圖形化介面（Enable Homebridge UI），當然是選 yes，就是為了方便管理才選這個套件的。

1. 完成安裝：最後在確認設定的畫面，再按下一步（或應用）就會開始進行安裝囉。

1. 開啟 Homebridge：安裝成功後，會在 NAS 的主選單中看到多了一個 Homebridge 圖示，請點擊他，會另開一個新的網頁。

1. 登入後台：預設登入帳密是 admin/admin，登錄後可以自己再到設定裡新增其他帳號來使用。

1. 掃描 QR Code：進入後就會看到這樣的首頁介面，會有一個大大的 QR Code，以及 Homebridge 的運行狀態。這時可以先拿起你的 iPhone 或 iPad，開啟「家庭」APP 來掃描這個 QR Code，將 Homebridge 加入。

1. 成功加入橋接器：加入後預設就會有一個像圖中這樣的橋接器，這無法操作什麼，但他很重要，橋接器搭建好後就可以開始加入有支援的家電。但在這之前，先說明一下介面上的「插件」跟「配置」。

首先是「插件」頁籤，你可以在這裡搜尋看看你想用的家電有沒有人已經開發了外掛，小米的家電普遍都有，其他廠牌就看狀況了。

再來是「配置」這一頁，預設會有一個 bridge 區塊，上面的 name、username、port、pin 都可以自行修改，格式一樣即可，但如果你看不懂，阿湯建議就照預設即可。到這邊為止，就建立好了和 Homekit 可以連動的 Homebridge 橋接器，是很重要的一個橋樑。

如何透過 Homebridge 外掛將小米家電加入 HomeKit？

將小米家電加入 HomeKit 的關鍵在於安裝正確的 Homebridge 插件（Plugin），並在配置檔中正確填入設備的 IP 與 Token，重啟後即可連動。由於每個家電的配置會略有不同，阿湯就以小米檯燈舉例，讓大家先了解一下安裝的流程。

1. 搜尋並安裝插件：先到插件裡搜尋看看有沒有你想加入的家電，但搜尋時不能單純以「小米檯燈」這樣的中文搜尋，要想一些英文關鍵字（例如 xiaomi desk lamp）打進去搜看看。至於哪一個一定可以用就得一個個試，還有憑一點經驗選擇，找到後點擊「安裝」。

1. 查看 NPM 說明：安裝完成後回到插件列表就會看到它。配置的部份，可以點擊每個插件左下角的「NPM」字樣來查看開發者提供的說明。

1. 複製配置代碼：點擊 NPM 會進到該插件的說明頁面，其中會包含這一段 JSON 格式的說明，跟你說配置檔的內容該怎麼寫。這部份阿湯很難教學，請看的懂的人再試著修改。

1. 儲存並重啟：然後回到 Homebridge 介面的「配置」頁籤，按照剛剛的說明將設備代碼加入後，按右上角「保存」，再點擊最右上方的「重啟」按鈕，將 Homebridge 重新啟動。

1. 確認運行狀態：重啟後，請確認右上角的三個綠燈都有亮起來，這表示你的配置檔格式沒有問題、系統正常運行。

1. 在家庭 APP 查看設備：正常來說，這時候不用做任何事，打開 iPhone 的家庭 APP 裡應該就可以看到剛剛加入的小米家電了。它會自動出現，因為是依附在我們一開始所加入的 Homebridge，未來只要在網頁上新增家電配置，就會在這裡直接出現。

要提醒的是，配置正常不等於一定能使用，因為有些插件可能太久沒更新，或者你選到的其實不支援你的家電（但名稱可能讓你誤會的），這時就是直接找看看別的插件再試看看，再接再厲。

小米家電 Token 與 IP 怎麼取得？（使用模擬器教學）

取得小米 Token 最快的方式是透過具備 Root 權限的 Android 模擬器，安裝米家 APP 後提取內部的 miio2.db 資料庫檔案，再透過解析網站讀取數據。

後面來補充一下小米家電的部份，由於小米類的設備基本上在配置時都會有 token 跟 IP 的欄位，這二個可以同時一起取得。但 IP 阿湯會建議將小米家電的 IP 在路由器端設定為「固定 IP」，不然有時斷開重連，Homekit 上的 IP 是不會跟著變動的，會導致設備失聯。Token 取得方式有點麻煩，阿湯就大概的說明給大家做參考。

1. 提取資料庫檔案：取得方式推薦用 Android 模擬器，例如夜神模擬器，並啟用模擬器的 root 權限（大部份模擬器都有設定可以開）。然後在裡面安裝米家 APP 後登入你的帳密。接下來請使用可以查看 root 目錄的檔案瀏覽器，進到路徑「/data/data/com.xiaomi.smarthome/databases/」。如果你的手機本身有 root 的話，也可以直接在自己手機上操作。在這資料夾裡會看到有個檔案叫做「miio2.db」，請將他複製出來到電腦上吧。
2. 上傳至解析網站：然後到這個 miio 網站，選擇我們取得的 miio2.db 檔案上傳。
   • miio 解析網站：請點我

1. 取得 Token 與 IP：上傳解析後，就會看到所有你有登入在米家 APP 的家電清單，包括我們在 Homebridge 配置中可能會需要用到的 IP、Token、mac 位址，這樣一次取得是最快的。

阿湯這邊就簡單的介紹到這邊，這做法已經算是相對簡單的。之後阿湯打算再將家中的電燈開關慢慢的改成有支援的 Wi-Fi 開關，然後加入到 Homekit 來用 Siri 控制，有興趣的就去研究看看吧，任何問題也歡迎和我討論。

常見問題