2026 年 Hermes Agent Mac 版安全配置最完整指南
安全指南 2026-05-23

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

發生洩漏疑慮或定期維護時,按順序執行:

  1. 立即停止 Gateway:launchctl unload 或退出 gateway 程序;
  2. 在雲端控制台吊銷並重建所有可能暴露的 key(LLM provider、Telegram bot、GitHub PAT);
  3. 更新 ~/.hermes/.env,確認舊 key 已刪除;
  4. 檢查 ~/.hermes/logs/ 與 shell 歷史,確認無 key 明文;
  5. 若 Gateway token 曾暴露,輪換 pairing 資料:hermes pairing list/revoke;
  6. 重啟 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. 第 1 週:CLI + manual 審批 + 專用目錄 + 單 provider key;
  2. 第 2 週:接入 Gateway,DM pairing,僅自己 ID;
  3. 第 3 週:切 docker 後端,綁定單一程式碼倉庫;
  4. 生產:獨立 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 關進你劃定的邊界裡。

Mac mini M4 · 專用 Agent 節點

M4.S 7×24 靜默執行

10 核 CPU 16GB 記憶體 權限隔離
$105.9
/ 月起
立即獲取