这次更新，我们把 Docker 体验彻底捋顺了

這次更新，我們把 Docker 體驗徹底捋順了

各位好，又到了咱們 Hermes 的更新解讀時間。這次 v2026.5.29 的更新，重點圍繞 Docker 部署做了不少「潤物細無聲」的改進。如果你之前被儀表板無限重新整理、容器裡跑任務莫名其妙中斷這些問題折磨過，那這次更新就是來「救火」的。

儀表板不再「轉圈圈」了

先說說最直觀的體驗修復。之前不少朋友回報，打開儀表板頁面，載入圖示轉個不停，重新整理也沒用，非常讓人抓狂。這次更新從根上解決了這個無限重新整理的問題，現在打開就是乾淨俐落的介面，資料載入穩定多了。

Docker 安全模式：預設更穩，出事兒自動重啟

這次 Docker 映像檔的底層管理邏輯換成了 s6-overlay 來「看護」閘道程序。你可以把它理解成給容器請了個「保母」：

• 如果閘道程序意外崩潰，幾秒鐘內會自動拉起來，容器本身不會掛掉，你的工作階段和任務也不會丟。
• 儀表板也是由 s6 統一監管的，崩了同樣會自動重啟，不用你再手動去 docker restart 了。

如果你出於某些特殊原因（比如 CI 測試）想要回到以前「容器退出 = 閘道退出」的老邏輯，可以在啟動命令裡加上 --no-supervise 或者設定環境變數 HERMES_GATEWAY_NO_SUPERVISE=1。不過對於生產環境，預設的監管模式絕對是更優解，強烈建議保持預設。

看板任務中斷？加個「斷路器」吧

很多朋友用 Hermes 跑無人值守的閘道任務（比如接 Telegram 機器人），最怕的就是 Agent 陷入某個死循環裡出不來，光警告不幹活。這次更新特別強調了 tool_loop_guardrails 配置。

簡單說，你可以在 config.yaml 裡開啟「硬停止」開關，給 Agent 套上韁繩：

tool_loop_guardrails:
  hard_stop_enabled: true
  hard_stop_after:
    exact_failure: 5
    idempotent_no_progress: 5

這樣當 Agent 連續失敗 5 次，或者重複執行無進展的操作 5 次，系統就會強制中斷，避免任務卡死浪費資源。

快速上手：一條命令搞定

如果你是第一次接觸，建立資料目錄並啟動設定精靈依然很簡單：

mkdir -p ~/.hermes
docker run -it --rm \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent setup

友情提醒：千萬別在 VPS 廠商自帶的網頁控制台裡貼上這些命令，特殊字元會被轉義搞亂（比如 : 變成 ;）。老老實實走 SSH 連線最穩妥。

跑起來：閘道 + 儀表板

配置好後，背景執行閘道並開啟儀表板：

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  -p 9119:9119 \
  -e HERMES_DASHBOARD=1 \
  nousresearch/hermes-agent gateway run

想要對外提供 API 服務，記得設定 API_SERVER_ENABLED=true 並配上強密碼（用 openssl rand -hex 32 生成）。

這次更新把 Docker 部署的穩定性提升了一大截，特別是 s6 監管機制的引入，讓無人值守場景安心了不少。趕緊拉取新映像檔試試吧！

---