HACS 安裝＋整合設定

HACS 是 Home Assistant 的一個社群商店，允許用戶安裝和管理自訂的整合和前端元件。它提供了一個介面，讓用戶可以瀏覽、安裝和更新各種由社群開發的擴充功能，從而擴展 Home Assistant 的功能。當你在 Home Assistant 內建的 integration 找不到所需資源時，可以透過 HACS 尋找並安裝更多社群提供的整合或元件。

請注意，HACS 雖然能夠提供更多元且彈性的擴充功能，但這些內容並非 Home Assistant 官方認證，可能會存在相容性問題或功能上的限制。在安裝和使用社群套件時，建議多加留意相關說明與風險。

HACS(Home Assistant Community Store) 安裝

本教學同步 HACS 官方最新流程（2025），分成兩部分：

• 第一部分：透過 Add-on Installer 安裝 HACS（官方推薦方式）
• 第二部分：設定整合並完成 GitHub 驗證（官方新版 device code 流程）

一、安裝前準備

• 已啟動的 Home Assistant Black
• 已完成基礎設定
• 可登入 Web UI（例：http://homeassistant.local:8123）
• 建議 Home Assistant 更新至最新版本
• 必備：GitHub 帳號（HACS 驗證必需）

GitHub 註冊：https://github.com/signup

二、HACS 安裝流程（官方 Add-on 安裝方式）

官方最新方式不再手動上傳 ZIP，而是透過 HACS Installer Add-on 自動完成下載與部署。

步驟 1：開啟官方 HACS Installer 下載頁

使用電腦瀏覽器開啟：

https://www.hacs.xyz/docs/use/download/download/#to-download-hacs

步驟 2：點擊「Open your Home Assistant instance」

頁面會提供官方深連結，按下後會自動跳轉到你的 Home Assistant。

步驟 3：安裝 HACS Installer Add-on

• 按 Install
• 安裝完成後按 Start

此 Add-on 會自動下載並安裝 HACS，本身不會長期佔用資源。

步驟 4：重新啟動 Home Assistant

安裝完成後，請重新啟動系統：

設定 → 系統 → 重新啟動

三、HACS Integration 設定（整合＋ GitHub 驗證）

重啟後，只是「安裝完成」，要能使用 HACS，還需要新增整合並完成 GitHub 驗證。

步驟 1：開啟 Devices & Services

設定 → 裝置與服務（Devices & Services）

步驟 2：新增整合

點右下角的「新增整合 Add Integration」

搜尋：HACS → 點選

步驟 3：勾選選項並送出

HACS 會顯示隱私與規定的勾選項，全部勾選後按「送出」。

步驟 4：取得 GitHub 驗證碼

系統會顯示一組 device code 以及提示你前往 GitHub 驗證。

步驟 5：進到 GitHub 驗證頁

請開啟：

https://github.com/login/device

步驟 6：完成授權

• 輸入剛剛顯示的驗證碼
• 登入 GitHub
• 按下「Authorize」授權 HACS

步驟 7：回到 Home Assistant 完成整合

授權成功後，Home Assistant 會回到 HACS 安裝畫面並完成整合。

四、HACS 安裝與整合流程圖（最新版）

【流程 1：安裝 HACS】

（你會在文章下方看到我提供的圖片流程圖）

【流程 2：設定 HACS＋GitHub 驗證】

（同樣有圖片版流程圖）

五、完成後你可以使用 HACS 來做什麼？

• 安裝第三方整合（Integrations）
• 安裝自訂卡片 UI（Mushroom、ApexCharts 等）
• 安裝主題（Themes）
• 匯入自動化藍圖（Blueprints）

如果你使用 Home Assistant Black，強烈建議安裝 HACS 來提升整體可用性。

以上謝謝您的購買 Home Assistant 智慧家庭套件 ，我們會持續發表各式技術文件。