產品說明

Home Assistant (簡稱 HA) 是全球最受歡迎的開源智慧家庭自動化平台。如果你的家裡同時擁有 Apple HomeKit、Google Home、小米米家、Philips Hue 或是各種雜牌的物聯網設備，你會發現它們彼此不互通，且過度依賴雲端服務。Home Assistant 的出現就是為了打破這些圍牆。

它是一個運行在本地端（如 Raspberry Pi 或 NAS）的伺服器，強調隱私與本地控制。這意味著即使網際網路斷線，你的電燈開關與自動化邏輯依然能正常運作。它擁有超過 2,500 個官方與社群維護的整合元件（Integrations），能將幾乎所有品牌的智慧家電統一接入同一個介面管理，並透過強大的自動化引擎實現「如果…就…」的複雜場景。

核心特色：

萬物互聯：支援 Zigbee, Z-Wave, Matter, Bluetooth, Wi-Fi 等通訊協定，打破品牌生態系壁壘。
隱私至上：所有數據皆儲存在你家中的硬碟裡，不會被傳送到雲端伺服器進行分析或販售。
強大自動化：比 IFTTT 更強大的邏輯引擎，可根據太陽方位、家人位置、電力消耗或感測器數值觸發動作。
能源管理：內建能源儀表板（Energy Dashboard），配合電表數據可視覺化家中用電、太陽能發電與電池儲能狀態。
高度客製化儀表板：Lovelace UI 允許使用者完全自訂控制面板，無論是極簡風還是科幻風都能實現。

常用指令

雖然 Home Assistant 主要透過網頁介面操作，但對於進階使用者或系統維護者來說，掌握 Home Assistant CLI (ha) 是解決系統問題的關鍵。這些指令通常在連接螢幕的終端機或 SSH 中執行。

系統管理與維護

# 檢查設定檔是否正確 (在重啟前必做)
ha core check

# 重新啟動 Home Assistant Core 服務
ha core restart

# 更新 Home Assistant 到最新版本
ha core update

# 重新啟動主機系統 (Reboot Host)
ha host reboot

備份與還原

# 建立一個完整的系統備份 (Full Backup)
ha backups new --name "Before_Update_20260106"

# 列出所有現有的備份檔
ha backups list

# 從指定 Slug 的備份檔還原
ha backups restore <slug>

YAML 自動化範例

Home Assistant 的靈魂在於 configuration.yaml 與 automations.yaml。以下是一個經典的自動化邏輯範例：

# automations.yaml 範例：當沒人在家且太陽下山時，打開玄關燈
alias: "Turn on porch light when away and sun sets"
trigger:
  - platform: sun
    event: sunset
    offset: "-00:30:00"  # 日落前 30 分鐘觸發
condition:
  - condition: state
    entity_id: group.family
    state: "not_home"    # 確認家人都不在家
action:
  - service: light.turn_on
    target:
      entity_id: light.porch_light
    data:
      brightness_pct: 50

進階技巧

HACS (Home Assistant Community Store)：雖然不是官方內建，但幾乎是必裝的「第三方應用商店」。透過 HACS，你可以一鍵安裝社群開發的自訂整合元件（Custom Components）與前端卡片（Frontend Cards）。
ESPHome：如果你喜歡 DIY 硬體，ESPHome 可以讓你用幾行 YAML 程式碼就將 ESP8266/ESP32 開發板變成原生的 Home Assistant 感測器或控制器，完全無需寫 C++。
Node-RED 整合：如果覺得 YAML 寫邏輯太抽象，可以安裝 Node-RED 插件，用「拉管線」的視覺化方式來設計超複雜的自動化流程。

Home Assistant