← 返回筆記
2026年7月18日

Agent 如何安全管理 Home Assistant 與 RockCoffee 網站

以私人 Mac 隔離管理 Home Assistant 與公開網站,依修改範圍安排文件備份、設定驗證與部署回復。

最後更新:

AI AgentHome AssistantWebSecurity

為什麼要記錄這套方法

讓 AI Agent 管理智慧家庭與網站,真正困難的不是「能不能連上」,而是如何在方便、自動化與安全之間取得平衡。

經過不同連線方式、設定來源與部署流程的嘗試後,目前 RockCoffee 採用一個清楚的原則:Agent 在私人 Mac 上工作,Home Assistant 與公開網站彼此隔離,每次操作都必須能驗證、能回復。

整體架構

Rock 提出需求
      │
Mac 上的 AI Agent
      │
按需查閱共享 Markdown 事實與目前授權規則
      │
      ├── Home Assistant:私人 API/SSH/設定驗證
      │
      └── RockCoffee:Astro 建置/備份/SSH 部署

Mac 是整套系統的私人控制面。小可是夥伴稱呼與網站導覽角色;Codex、OpenClaw、Hermes 三個 Agent 依任務分工,按需查閱共享 Markdown 知識庫中的已核實事實與安全規則。接手時先讀短交接,有疑問再查來源,不預設自動載入全部文件。共同資料不能取代當下使用者指示或更新的驗證證據。

Agent 管理 Home Assistant 的方式

Home Assistant 的工作分成三層,不把所有事情都交給同一條連線處理。

1. 狀態查詢

Agent 預設先做只讀檢查,透過 HTTP 可達性、主機與容器狀態、近期紀錄及設定檢查交叉判斷。單一連線失敗或一次負載尖峰,不會直接被當成整套系統故障。

2. 一次性控制

開燈、播放廣播或執行情境等已授權動作,由 Mac 透過 Home Assistant 的驗證 API 呼叫服務。

3. 正式設定維護

需要修改自動化或設定時,Agent 透過金鑰驗證的 SSH 連到 Home Assistant 主機,直接以主機端正式設定為準,不使用可能過期的本機副本。

穩定的修改順序是:

  1. 備份正式設定。
  2. 只做必要的最小修改。
  3. 檢查 YAML 或資料格式。
  4. 在 Home Assistant 容器內執行正式設定驗證。
  5. 通過後才重新載入受影響的功能。

Agent 管理 RockCoffee 網站的方式

網站原始內容保存在 Mac,由 Astro 將 Markdown、JSON、元件與樣式組合成純靜態檔案。

每次更新採用固定部署流程:

  1. 在 Mac 修改內容或程式。
  2. 執行型別、內容與網站建置檢查。
  3. 在網頁主機建立目前版本的壓縮備份。
  4. 透過 SSH 金鑰與安全複製,將新版靜態檔案送到獨立的網頁環境。
  5. 校正目錄與檔案權限,移除 Mac 產生的額外 metadata。
  6. 從外部逐一驗證首頁、主要頁面、圖片與遊戲。
  7. 部署中途若失敗,就用剛建立的備份回復舊站。
SITE TOUR

第一次來?四站認識 RockCoffee

不用先懂技術,跟著 Rock 的實作路線看就好。

  1. 01
    先看智慧家庭

    用模擬情境理解自動化如何替生活減少瑣事。

    前往展示
  2. 02
    認識 AI Agent

    透過小可認識 Hermes、OpenClaw、Codex 三個 Agent 的分工。

    查看角色分工
  3. 03
    再逛長期專案

    看看 Home Assistant、家庭網路與 Home Lab 如何合作。

    瀏覽專案
  4. 04
    沿著里程碑回顧

    從網域、主機到 AI Agent,依時間看見系統如何成長。

    查看里程碑