HA 設定用 packages 拆：刪掉一個檔，那個功能就乾淨消失

charles

這篇的內容（10 段）

1. 為什麼是 packages，不是 !include
2. 步驟 1：先備份，再動手
3. 步驟 6：驗證它真的被載入了
4. 步驟 7：用子資料夾分組
5. 步驟 9：搬家的順序
6. 設計這套結構時的幾個原則
7. 每個自動化都要有 id
8. 門檻值用 input_number，不要寫死
9. 檔案開頭寫註解
10. 一整套命名慣例

這一篇做完，你的 configuration.yaml 會只剩下十幾行，所有實際的邏輯搬進 packages 資料夾，而且「一個功能 = 一個檔案」——不要了就刪那個檔，相關的感測器、輔助元件、自動化、腳本會一起乾淨消失，不會留任何殘渣。



為什麼是 packages，不是 !include

一句話：刪除的時候不會留垃圾。

假設你做了一套「陽台植物澆水」，它包含一個濕度門檻的輔助元件、一顆判斷太乾的範本感測器、兩個自動化、一支手動澆水的腳本。

用傳統的 `!include` 拆法，這四樣東西會分別躺在 `input_numbers.yaml`、`templates.yaml`、`automations.yaml`、`scripts.yaml` 四個檔案裡。哪天不玩了，你要去四個地方各刪一段——一定會漏掉一個，然後那個孤兒實體會在你的實體清單裡留三年。

用 packages 的話，那四樣東西全部在 `packages/plants.yaml` 裡面。刪掉那個檔，整套消失。

步驟 1：先備份，再動手

這一步不要跳。設定 → 系統 → 備份 → 建立備份，等它跑完。

你會看到備份清單多一列，而且有今天的日期。

有裝 git 的話順便提交一次：

1. cd /config
2. git add .
3. git commit -m "整理 packages 之前"

複製代碼

步驟 2：看清楚你現在的 configuration.yaml 有什麼

用 Studio Code Server 應用程式（設定 → 應用程式 → 應用程式商店 裝，2026.2 之前這裡叫「附加元件」）打開 `/config/configuration.yaml`。

把內容從上到下讀一遍，分成三類：

• 系統層：`homeassistant:`、`default_config:`、`frontend:`、`logger:`、`recorder:` — 這些留在原地
  
• !include 那幾行：`automation: !include automations.yaml` 之類 — 留著，介面編輯的自動化還是會寫進那個檔
  
• 實際的邏輯：一堆 `template:`、`sensor:`、`input_number:`、`binary_sensor:` — 這些是要搬的
  

⚠ 有一個東西絕對不能搬：`auth_providers:`

官方明講 Home Assistant 在啟動的很早期就處理 `auth_providers`，那時候 packages 還沒被讀進來。搬過去的結果是它完全不生效，而且你會被鎖在登入畫面外面。

步驟 3：檢查 http: 區塊還在不在（2026.8 之後的新狀況）

很多人的 `configuration.yaml` 裡有這一段：

1. http:
2.   use_x_forwarded_for: true
3.   trusted_proxies:
4.     - 192.168.1.20

複製代碼

Home Assistant 2026.8 起，http 設定已經從 YAML 搬到介面上了。

升級之後第一次啟動時，HA 會把你原本的 `http:` 區塊自動匯入，然後在 設定 → 系統 → 修復 開一個通知提醒你刪掉 YAML 那一段。YAML 支援會在 2027.2 完全移除。

現在該做的：

• 1. 到 設定 → 系統 → 網路，找到 HTTP 伺服器 區塊
  
• 2. 你會看到你原本寫在 YAML 裡的值已經在那裡了（反向代理、信任的代理 IP）
  
• 3. 確認無誤之後，把 `configuration.yaml` 裡的 `http:` 整段刪掉
  
• 4. 重啟 Home Assistant
  

網路頁面上的欄位是灰色不能改的：代表 `configuration.yaml` 裡還有 `http:`。YAML 存在時介面就是唯讀的——刪掉那一段再重啟就能改了。

以下還有約 80% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入