Home Assistant OS 附加元件部署

1. 適用範圍

2. 新增雲瞰儲存庫

推薦方式:一鍵跳轉。 在能存取 HA 的裝置上開啟本頁,點擊下方徽章,my.home-assistant.io 會自動找到你的 HA 並預先填入儲存庫位址,確認即可。

第一次點擊會要求填入你的 HA 位址(如 http://homeassistant.local:8123),之後會自動記住。如果跳轉失敗或沒有安裝 My Home Assistant 整合,請使用下方的手動方式。

手動方式:

1. 1

   進入附加元件商店

   HA 網頁 → 設定(Settings) → 附加元件(Add-ons) → 附加元件商店(Add-on Store)

2. 2

   新增自訂儲存庫

   右上角三點選單 → 儲存庫(Repositories) → 貼上下方 URL → 新增(Add)

3. 3

   貼上這個 URL

   下面整段位址,直接複製貼上:

https://github.com/mrtian2016/yunkan-hassio-addons

新增後頁面會重新整理,附加元件商店底部會多出一欄「Yunkan」,裡面有 yunkan 和 yunkan-openvino 兩張卡片。

3. 安裝並啟動

1. 1

   選變體

   Intel 機型點 yunkan-openvino,其他點 yunkan

2. 2

   安裝

   右下角「安裝(Install)」按鈕,等下載完成(映像檔約 700MB,首次需要幾分鐘)

3. 3

   設定(選用)

   「設定(Configuration)」標籤頁:預設值即可正常運作;有特殊需求(自訂連接埠、時區)在這裡調整

4. 4

   啟動

   「資訊(Info)」標籤頁 → 「啟動(Start)」按鈕

5. 5

   開啟自動啟動 + Watchdog

   把下方兩個開關都打開:「啟動時啟動」+「Watchdog」;確保 HA 主機重新啟動或附加元件崩潰時能自動拉起

6. 6

   開啟網頁

   側邊欄會出現「雲瞰」入口(或造訪 http://<HA 主機IP>:23406/)進入 Setup 精靈

4. 資料持久化

附加元件的資料會自動放到 HA 的 /share/yunkan/ 目錄(錄影、資料庫、模型、115 cookies 都在這裡)。這個目錄:

• HA OS 備份會一併帶上 — Supervisor → Backups 做整機備份會包含 /share/,雲瞰的資料也會一起備份
• 可透過外部 SMB 存取 — HA 預設的 Samba 附加元件會映射 /share/,可以從電腦/NAS 瀏覽錄影檔案
• 升級不會遺失 — 附加元件升級只是更換映像檔,/share 裡的持久化資料會保留

5. 升級

雲瞰附加元件走 HA 附加元件標準升級流程:HA 偵測到新版本會通知(右下角 + 設定 → 附加元件 → 目前附加元件 → 上方黃色橫條),點 "更新" 即可。雲瞰網頁後台會自動識別附加元件環境並給出對應升級指引,無需安裝任何額外升級元件。

6. 常見問題