2026 年 Hermes Agent Mac 版安全配置最完整指南:權限、密鑰和檔案邊界怎麼設?
Hermes Agent 能讀檔案、跑命令、調 API——安裝完成後真正決定能否長期放心使用的,不是模型多強,而是權限邊界。本文給出一套 Mac 版安全 baseline:最小目錄、最小密鑰、最小命令集,再按需擴權。
2026 年在 Mac 上安裝 Hermes Agent,許多人第一步就錯了:模型連上、Gateway 跑起來,就把整台機器交給 agent。官方文件寫得很清楚——對抗惡意 LLM 行為的唯一硬邊界是作業系統。Hermes 提供了命令審批、容器隔離、Gateway 白名單等多層防護,但這些都是「在 OS 邊界之上的縱深防禦」,不能替代你自己劃定的檔案與密鑰範圍。
先行結論:Hermes Agent 不應預設獲得整個使用者目錄和所有命令權限。先用最小工作目錄、最小密鑰集、approvals.mode: manual 跑通一條任務,再逐步擴權。下面按「安裝後 30 分鐘內就該做完」的順序展開。
1. 為什麼安裝後要先設邊界
Hermes 預設 terminal.backend: local,命令直接在 Mac 上以目前使用者身分執行。Gateway 若未設定白名單,啟動時會拒絕所有外部使用者——這是 fail-closed 的好設計;但若你為了「先跑起來」打開 GATEWAY_ALLOW_ALL_USERS=true,任何能聯絡到 bot 的人都能觸發工具呼叫。
風險不在「AI 會不會作惡」,而在三類可預期失誤:
- 誤刪/誤改:遞迴
rm、覆寫~/.ssh或~/.hermes/.env; - 密鑰洩漏:日誌、MCP 子程序或容器環境變數把 API key 帶出;
- 越權呼叫:未授權使用者透過 Telegram/Discord 等入口觸發部署、群發或支付腳本。
安全設定的目標不是關掉功能,而是讓 agent 只在它需要工作的範圍內行動。下面這張分層表可作為整篇的導航:
| 資產層 | 典型路徑/物件 | 建議策略 | 主要風險 |
|---|---|---|---|
| 個人檔案 | ~/Documents、~/Pictures、iCloud | 禁止 agent 預設存取 | 隱私洩漏、誤刪照片/文稿 |
| 工作目錄 | ~/hermes-workspace | 允許讀寫;設 MESSAGING_CWD | 越界寫入系統目錄 |
| 程式碼倉庫 | ~/Projects/某倉庫 | 詢問 git push/merge;禁止直接改 main | 未審查程式碼上線 |
| 密鑰 | ~/.hermes/.env | 禁止 agent 讀寫;chmod 600 | API 帳單失控、帳號接管 |
| 生產資源 | 雲端控制台、K8s、資料庫 | 禁止 長週期憑證;短效 scoped token + 詢問 | 容器隔離也擋不住高權限 key |
| 外部訊息 | Telegram/Slack/Discord | 詢問 群發;白名單 + DM pairing | 釣魚、垃圾訊息、聲譽風險 |
2. 該用主力 macOS 使用者嗎?專用工作區怎麼劃
2.1 執行身分:主力使用者 vs 專用帳號
不建議讓長期執行的 Gateway 直接使用你的日常 macOS 帳號。日常帳號通常已授權照片、郵件、瀏覽器密碼等——agent 一旦以 local 後端執行命令,繼承的是該使用者的完整 TCC 權限面。
更穩妥的三檔方案:
- 本機試用(低風險):仍用主力帳號,但僅 CLI 互動、
local後端、工作目錄鎖在專用資料夾; - 專用 macOS 使用者(推薦):系統設定 → 使用者與群組,新建標準使用者
hermes,只掛載工作目錄與必要 SSH key; - 獨立機器/VM(生產 Gateway):
terminal.backend: ssh指向另一台 Mac mini 或 Linux worker,Gateway 只負責訊息路由。
Hermes 官方 SECURITY.md 也強調:多使用者隔離必須在 OS/主機層完成,應用內 session key 只做路由,不是授權邊界。
2.2 目錄分區與 MESSAGING_CWD
在專用帳號下建立獨立工作區,不要把 agent 預設 cwd 設在 ~:
mkdir -p ~/hermes-workspace/{inbox,outbox,scratch,backups}
chmod 700 ~/hermes-workspace
在 ~/.hermes/.env 中設定:
MESSAGING_CWD=/Users/hermes/hermes-workspace
分區建議:
- inbox:唯讀或半唯讀——agent 可讀取待處理材料;
- scratch:可寫——暫時腳本、建置產物;
- outbox:可寫——輸出報告,人工抽查後再外傳;
- backups:agent 無寫權限——你用 Time Machine 或 rsync 單獨備份。
程式碼倉庫若必須接入,建議只 bind 單一 repo 子目錄,而不是整個 ~/Projects。Docker 持久化模式下,容器內 /workspace 對應到 ~/.hermes/sandboxes/docker/——定期清理舊 sandbox,避免敏感檔案長期殘留。
3. 密鑰與 API Key:放哪裡、怎麼輪換
3.1 存放位置與權限
Hermes 要求所有 API key 和 token 只放在 ~/.hermes/.env,不要寫進 config.yaml 或 git 倉庫。安裝後立即執行:
chmod 600 ~/.hermes/.env
chmod 700 ~/.hermes
各類儲存的適用邊界:
| 方式 | 適用場景 | 注意 |
|---|---|---|
~/.hermes/.env |
本機 Gateway/CLI 預設方案 | 必須 chmod 600;勿提交 git |
| macOS 鑰匙圈 | SSH 部署 key、短期人工注入 | Hermes 不會自動讀鑰匙圈;需啟動腳本匯出 |
| Skill 宣告的 env | 單一 Skill 需要的第三方 API | 會進入容器 passthrough;只給最小 scope |
| 雲端 Secret Manager | 團隊生產、CI/CD | 注入到 worker 的 .env,不經過聊天通道 |
3.2 不要把 provider key 透傳進容器
terminal.docker_forward_env 和 terminal.env_passthrough 會把變數注入 Docker/本機子程序。切勿把 OpenAI/Anthropic 等 provider 主密鑰加入 passthrough——容器內程式碼可讀並外傳。只透傳任務級 token(如受限的 GITHUB_TOKEN)。
MCP 子程序預設只接收 PATH、HOME 等安全變數;需在 MCP 設定的 env: 區塊裡明確宣告才會傳入,這是有意設計。
3.3 密鑰輪換 checklist
發生洩漏疑慮或定期維護時,按順序執行:
- 立即停止 Gateway:
launchctl unload或退出 gateway 程序; - 在雲端控制台吊銷並重建所有可能暴露的 key(LLM provider、Telegram bot、GitHub PAT);
- 更新
~/.hermes/.env,確認舊 key 已刪除; - 檢查
~/.hermes/logs/與 shell 歷史,確認無 key 明文; - 若 Gateway token 曾暴露,輪換 pairing 資料:
hermes pairing list/revoke; - 重啟 Gateway,用最小任務驗證後再恢復自動化。
4. 命令與檔案權限:允許/詢問/禁止
Hermes 內建危險命令偵測(tools/approval.py)。在 ~/.hermes/config.yaml 中保持:
approvals:
mode: manual # manual | smart | off
timeout: 60 # 逾時預設拒絕(fail-closed)
smart 模式用輔助 LLM 評估風險——適合熟練使用者;off 或 /yolo 等同關閉審批,僅在 disposable 容器或 CI 中使用。硬線 blocklist(如 rm -rf /、fork bomb)無論 YOLO 與否都會拒絕。
4.1 可直接套用的策略模板
| 操作類型 | 策略 | Hermes 側設定 |
|---|---|---|
| 讀工作區內檔案 | 允許 | MESSAGING_CWD + 目錄隔離 |
| 遞迴刪除、寫 /etc、寫 ~/.ssh | 禁止/必審 | manual 模式 + 勿加入 command_allowlist |
| brew/npm/pip 安裝 | 詢問 | 預設觸發審批;容器內可放寬 |
| git commit(本機) | 允許 | 限制 repo 路徑 |
| git push/部署/docker push | 詢問 | 每次人工確認;停用 always allow |
| 對外 HTTP(公網) | 詢問 | security.website_blocklist 攔內網/metadata |
| 自動發送群訊息/郵件 | 禁止自動 | Gateway 回覆需人工 yes/no |
CLI 審批選項:once/session/always/deny。生產環境避免對 rm、systemctl 等使用 always——會寫入 command_allowlist 永久放行。用 hermes config edit 定期稽核該列表。
4.2 生產環境優先 Docker 隔離
當 terminal.backend: docker(或 modal/daytona/vercel_sandbox)時,危險命令偵測會跳過——容器本身就是邊界。Docker 預設 drop 全部 capability、限制 pids、tmpfs 隔離 /tmp。設定範例:
terminal:
backend: docker
docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
docker_forward_env: [] # 空 = 不把主機密鑰帶進容器
container_cpu: 1
container_memory: 5120
container_disk: 51200
container_persistent: true
注意:容器預設仍可存取公網。若 skill 不需要連網,在 Docker 層限制 egress 或使用 --network=none 策略。
5. macOS 隱私權限:保守授權
Hermes CLI/Gateway 若需讀檔案、控制瀏覽器或截圖,會觸發 macOS TCC 彈窗。路徑因 macOS 版本略有差異,但原則一致:只給完成功能所需的最小權限,且優先在專用使用者下授權。
- 檔案與資料夾:僅新增
hermes-workspace,不要選「整個磁碟」或 Documents; - 自動化(Apple Events):若不用 Hermes 控制 Mail/Notes,拒絕;
- 輔助使用/螢幕錄製:browser 工具需要時再開;日常 CLI 可不用;
- 完整磁碟取用權限:除非明確需要,否則不要授予——等同繞過 TCC。
系統設定 → 隱私權與安全性 → 對應類別,可隨時撤銷。升級 macOS 後建議複查一遍授權列表。
6. Gateway 使用者授權與日誌稽核
6.1 誰可以和 bot 說話
在 ~/.hermes/.env 設定白名單,不要在生產使用 GATEWAY_ALLOW_ALL_USERS=true:
TELEGRAM_ALLOWED_USERS=你的數字ID
GATEWAY_ALLOWED_USERS=你的數字ID
# 或使用 DM pairing:未知使用者收到 8 位碼,CLI 執行 hermes pairing approve
授權檢查順序:平台 allow-all 旗標 → pairing 已批准列表 → 平台白名單 → 全域白名單 → 預設拒絕。Pairing 碼 1 小時過期、10 分鐘限流、5 次失敗鎖定 1 小時——比硬編碼 ID 更靈活。
6.2 日誌應保留什麼
預設日誌目錄:~/.hermes/logs/。建議保留並定期輪替:
- Gateway 啟動警告(如未設定白名單);
- 危險命令審批記錄(批准/拒絕/逾時);
- 未授權使用者存取嘗試;
- Skill 安裝與 lazy install 事件;
hermes doctor輸出的供應鏈 advisory。
日誌本身可能含檔案路徑、命令參數和部分 prompt 片段——視為敏感資料,不要同步到公開雲端硬碟。MCP 錯誤回傳會自動 redact ghp_、sk- 等模式,但不能替代「少記密鑰」的習慣。
可啟用 security.website_blocklist 阻止 agent 存取內網 admin 面板;SSRF 防護預設攔截 RFC1918、metadata IP——除非你有 LAN 內 Ollama 等需求,否則保持 allow_private_urls: false。
7. 從低風險到高權限的擴權流程
不要第一天就 local + yolo + allow all users。推薦階梯:
- 第 1 週:CLI + manual 審批 + 專用目錄 + 單 provider key;
- 第 2 週:接入 Gateway,DM pairing,僅自己 ID;
- 第 3 週:切
docker後端,綁定單一程式碼倉庫; - 生產:獨立 Mac mini/VM + ssh 後端 + 資源限額 + 日誌告警。
每升一級,用 15 分鐘跑一遍「故意觸發審批」測試:刪暫存檔、curl 內網、嘗試 push——確認該攔的仍被攔。
8. 誤操作與洩漏:事件回應
誤刪檔案:若在工作區內,從 backups 或 Time Machine 還原;若已同步 git,git checkout。然後暫停 agent,查日誌定位觸發 prompt。
密鑰洩漏:按第三節輪換 checklist 執行;若 bot token 洩漏,在 Telegram @BotFather 重置並更新 .env。
越權呼叫:hermes pairing revoke <platform> <user_id>,檢查 Gateway Webhook URL 是否被暴露,必要時加防火牆/Tailscale 僅內網存取 Gateway。
異常 API 帳單:先在 provider 控制台設 spend limit,再查日誌裡是否有迴圈 tool call 或 cron 任務失控。
說明:Hermes 不保證「資料絕不離開本機」——模型 API、browser、web search 都會出站。若需純本機,需自行選擇本機模型路由並關閉相應工具。
9. 安裝後 30 分鐘安全檢查清單
- ☐ 建立
~/hermes-workspace並設定MESSAGING_CWD - ☐
chmod 600 ~/.hermes/.env,確認 config.yaml 無密鑰明文 - ☐
approvals.mode: manual,未啟用 YOLO - ☐ 稽核
command_allowlist為空或最小 - ☐ Gateway 設定白名單或 DM pairing,未開
GATEWAY_ALLOW_ALL_USERS - ☐ 生產 Gateway 使用
docker或ssh後端,非local - ☐
docker_forward_env: [],provider key 未透傳 - ☐ macOS 隱私權限僅覆蓋工作目錄
- ☐ 執行
hermes doctor,處理供應鏈 advisory - ☐ 確認
~/.hermes/logs/可寫且不在雲同步資料夾內
在 Mac mini 上跑 Hermes,邊界更清晰
把 Hermes Gateway 放在專用 Mac mini 上,是比「主力 MacBook 全開權限」更乾淨的分工:日常電腦繼續寫程式、回訊息;mini 只跑 agent、Docker sandbox 和日誌,物理上與個人照片、瀏覽器 Cookie 隔離。Apple Silicon 統一記憶體讓本機輔助模型(若你用 Ollama)更順暢;macOS 的 Gatekeeper、SIP、FileVault 提供系統級完整性保護,TCC 權限面也可在專用帳號上最小化。
Mac mini M4 待機功耗約 4W、無風扇靜音,適合 7×24 跑 Gateway 而不擾民;配合 terminal.backend: ssh,你甚至可以把命令執行推到另一台 worker,Gateway 節點只負責訊息與審批。若你正在搭建「可長期開著的 agent 主機」,Mac mini M4 是目前性價比最清晰的起點——現在即可入手,把 Hermes 關進你劃定的邊界裡。