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 主機,直接以主機端正式設定為準,不使用可能過期的本機副本。
穩定的修改順序是:
- 備份正式設定。
- 只做必要的最小修改。
- 檢查 YAML 或資料格式。
- 在 Home Assistant 容器內執行正式設定驗證。
- 通過後才重新載入受影響的功能。
Agent 管理 RockCoffee 網站的方式
網站原始內容保存在 Mac,由 Astro 將 Markdown、JSON、元件與樣式組合成純靜態檔案。
每次更新採用固定部署流程:
- 在 Mac 修改內容或程式。
- 執行型別、內容與網站建置檢查。
- 在網頁主機建立目前版本的壓縮備份。
- 透過 SSH 金鑰與安全複製,將新版靜態檔案送到獨立的網頁環境。
- 校正目錄與檔案權限,移除 Mac 產生的額外 metadata。
- 從外部逐一驗證首頁、主要頁面、圖片與遊戲。
- 部署中途若失敗,就用剛建立的備份回復舊站。