<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>自托管 on 记录点滴 - 分享</title><link>https://www.iminling.com/tags/%E8%87%AA%E6%89%98%E7%AE%A1/</link><description>Recent content in 自托管 on 记录点滴 - 分享</description><generator>Hugo -- gohugo.io</generator><language>zh-cn</language><copyright>iminling.com</copyright><lastBuildDate>Thu, 19 Nov 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://www.iminling.com/tags/%E8%87%AA%E6%89%98%E7%AE%A1/index.xml" rel="self" type="application/rss+xml"/><item><title>Hermes Agent 自托管架构总览：从部署到能力扩展的分层设计</title><link>https://www.iminling.com/ai/hermes/hermes-agent-architecture-overview/</link><pubDate>Thu, 19 Nov 2026 00:00:00 +0000</pubDate><guid>https://www.iminling.com/ai/hermes/hermes-agent-architecture-overview/</guid><description>&lt;img src="https://images.iminling.com/i/2026/11/19/1d4d42b6ab97d0d19a2591bcb284d39a.webp" alt="Featured image of post Hermes Agent 自托管架构总览：从部署到能力扩展的分层设计" /&gt;&lt;h2 id="写在前面"&gt;写在前面&#10;&lt;/h2&gt;&lt;p&gt;Hermes Agent 是 Nous Research 开源的通用 AI Agent。和 Claude Code、Codex 这类主要待在终端里的编程 CLI 不同，它更像一个常驻服务：挂在服务器上，通过飞书、Telegram、企业微信等聊天平台接收消息，按配置调用模型、工具和技能，再把结果送回聊天窗口。&lt;/p&gt;&#10;&lt;p&gt;我在一台内网服务器上跑了几个月 Hermes，配置一路改下来，已经从&amp;quot;能用&amp;quot;变成了一套有明确分层的系统。这个系列把它拆开讲清楚，本篇是总览：先建立整体模型，后续每篇再展开一层。&lt;/p&gt;&#10;&lt;p&gt;本文基于 Hermes Agent &lt;code&gt;v0.23.0&lt;/code&gt;（2026.9.24），使用官方 Docker 镜像部署。涉及账号、渠道 ID、模型网关地址的地方都用占位符替代。&lt;/p&gt;&#10;&lt;h2 id="整体模型"&gt;整体模型&#10;&lt;/h2&gt;&lt;p&gt;先看全貌。Hermes 在这套部署里可以分成六层：消息从最上面的接入层进来，经过角色层和能力层调用模型，记忆与状态贯穿全程，最底下的部署层承载所有进程和数据。&lt;/p&gt;&#10;&lt;pre class="mermaid" style="visibility:hidden"&gt;flowchart TB&#10; subgraph Entry["接入层 Gateway"]&#10; direction LR&#10; Chat[飞书 / Telegram / 企业微信] ~~~ API[api_server / webhook]&#10; end&#10;&#10; subgraph Role["角色层 Profiles"]&#10; Profiles[dev / product / tester / kb / home]&#10; end&#10;&#10; subgraph Agent["能力层"]&#10; direction LR&#10; Skills[Skills] ~~~ Plugins[Plugins / Hooks] ~~~ Cron[Cron]&#10; end&#10;&#10; subgraph Model["模型层"]&#10; direction LR&#10; Main[主模型 grok-4.7] ~~~ Aux[辅助模型 glm-5.3-flash]&#10; end&#10;&#10; subgraph State["记忆与状态层"]&#10; direction LR&#10; Mem[SOUL / MEMORY / USER] ~~~ DB[(state.db)]&#10; end&#10;&#10; subgraph Deploy["部署层"]&#10; direction LR&#10; Docker[Docker Compose + s6] ~~~ Data["数据卷 /opt/data"] ~~~ Dash[Dashboard]&#10; end&#10;&#10; Entry --&gt; Role --&gt; Agent --&gt; Model&#10; Agent &lt;--&gt; State&#10; Model ~~~ Deploy&#10; State ~~~ Deploy&lt;/pre&gt;&lt;p&gt;各层的分工可以用一张表概括：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;层&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;负责什么&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;主要配置位置&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;部署层&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;进程守护、数据持久化、Dashboard&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;docker-compose.yaml&lt;/code&gt;、&lt;code&gt;/opt/data&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;模型层&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;主对话模型、辅助任务模型、多模型协作&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;config.yaml&lt;/code&gt; 的 &lt;code&gt;model&lt;/code&gt;、&lt;code&gt;auxiliary&lt;/code&gt;、&lt;code&gt;moa&lt;/code&gt;、&lt;code&gt;providers&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;接入层&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;聊天平台收发、展示策略、会话切换&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;config.yaml&lt;/code&gt; 的 &lt;code&gt;platforms&lt;/code&gt;、&lt;code&gt;display.platforms&lt;/code&gt;、&lt;code&gt;.env&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;角色层&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;按用途隔离模型、技能和记忆&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;profiles/&amp;lt;name&amp;gt;/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;能力层&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;技能、插件、定时任务&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;skills/&lt;/code&gt;、&lt;code&gt;plugins/&lt;/code&gt;、&lt;code&gt;cron/&lt;/code&gt;、&lt;code&gt;scripts/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;记忆与状态层&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;人设、长期记忆、会话与任务状态&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SOUL.md&lt;/code&gt;、&lt;code&gt;memories/&lt;/code&gt;、&lt;code&gt;state.db&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;h2 id="关键组件"&gt;关键组件&#10;&lt;/h2&gt;&lt;h3 id="部署层一个容器一个数据目录"&gt;部署层：一个容器，一个数据目录&#10;&lt;/h3&gt;&lt;p&gt;整套服务只有一个 &lt;code&gt;hermes&lt;/code&gt; 容器，用 Docker Compose 管理：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt; 1&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 2&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 3&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 4&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 5&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 6&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 7&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 8&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 9&#10;&lt;/span&gt;&lt;span class="lnt"&gt;10&#10;&lt;/span&gt;&lt;span class="lnt"&gt;11&#10;&lt;/span&gt;&lt;span class="lnt"&gt;12&#10;&lt;/span&gt;&lt;span class="lnt"&gt;13&#10;&lt;/span&gt;&lt;span class="lnt"&gt;14&#10;&lt;/span&gt;&lt;span class="lnt"&gt;15&#10;&lt;/span&gt;&lt;span class="lnt"&gt;16&#10;&lt;/span&gt;&lt;span class="lnt"&gt;17&#10;&lt;/span&gt;&lt;span class="lnt"&gt;18&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;services&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;hermes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;image&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;nousresearch/hermes-agent:latest&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;container_name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;hermes&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;restart&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;unless-stopped&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;network_mode&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;host&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;volumes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;./data:/opt/data&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;/data/work:/data/work:ro&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;environment&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;TZ=Asia/Shanghai&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD=1&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_HOST=0.0.0.0&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_PORT=9119&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_BASIC_AUTH_USERNAME=&amp;lt;your-username&amp;gt;&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=&amp;lt;your-password&amp;gt;&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_BASIC_AUTH_SECRET=&amp;lt;random-secret&amp;gt;&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;command&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;gateway&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;run&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;p&gt;几个值得注意的点：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;容器内的 &lt;code&gt;HERMES_HOME&lt;/code&gt; 是 &lt;code&gt;/opt/data&lt;/code&gt;。配置、密钥、技能、会话数据库全部落在宿主机的 &lt;code&gt;./data&lt;/code&gt; 里，升级镜像不会丢状态。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;command: [&amp;quot;gateway&amp;quot;, &amp;quot;run&amp;quot;]&lt;/code&gt; 让容器以网关模式常驻；容器内部由 s6 负责守护网关进程。&lt;/li&gt;&#10;&lt;li&gt;工作目录 &lt;code&gt;/data/work&lt;/code&gt; 以只读方式挂载，Agent 能读代码和资料，但不能直接改宿主机文件。&lt;/li&gt;&#10;&lt;li&gt;服务器只在内网，所以使用 &lt;code&gt;network_mode: host&lt;/code&gt;，Dashboard 直接监听 &lt;code&gt;9119&lt;/code&gt; 端口，只配了 Basic Auth。暴露到公网时不应照搬这套配置。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;我早期还自己写过一个 Dockerfile，用来在镜像里装 Chromium，后来发现官方镜像已经通过 &lt;code&gt;PLAYWRIGHT_BROWSERS_PATH&lt;/code&gt; 自带 Playwright 浏览器，这一步完全多余。部署篇会详细说明数据目录结构和这类踩坑点。&lt;/p&gt;&#10;&lt;h3 id="模型层主模型干活小模型打杂"&gt;模型层：主模型干活，小模型打杂&#10;&lt;/h3&gt;&lt;p&gt;模型层最重要的设计是&lt;strong&gt;按任务分配模型&lt;/strong&gt;。&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;主对话使用 &lt;code&gt;grok-4.7&lt;/code&gt;，推理强度设为 &lt;code&gt;high&lt;/code&gt;。&lt;/li&gt;&#10;&lt;li&gt;上下文压缩、审批判断、标题生成、技能整理（curator）、后台复盘这些辅助任务，统一交给更便宜、更快的 &lt;code&gt;glm-5.3-flash&lt;/code&gt;，并关闭推理。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt; 1&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 2&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 3&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 4&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 5&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 6&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 7&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 8&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 9&#10;&lt;/span&gt;&lt;span class="lnt"&gt;10&#10;&lt;/span&gt;&lt;span class="lnt"&gt;11&#10;&lt;/span&gt;&lt;span class="lnt"&gt;12&#10;&lt;/span&gt;&lt;span class="lnt"&gt;13&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;default&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;grok-4.7&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;provider&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;custom:newapi-grok&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;auxiliary&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;compression&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;provider&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;custom:newapi-glm&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;glm-5.3-flash&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;reasoning_effort&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;none&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;title_generation&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;provider&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;custom:newapi-glm&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;glm-5.3-flash&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;reasoning_effort&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;none&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;p&gt;所有模型都通过一个自建的 NewAPI 网关接入，按协议拆成几个 named provider 声明，密钥只通过 &lt;code&gt;key_env&lt;/code&gt; 引用环境变量，不写进配置文件。此外还配置了 MoA（Mixture of Agents）：用 &lt;code&gt;/moa&lt;/code&gt; 标记某一轮时，先让几个不同厂商的模型给出参考意见，再由主模型汇总回答。模型篇会讲清楚这些取舍和成本。&lt;/p&gt;&#10;&lt;h3 id="接入层一个网关多个聊天平台"&gt;接入层：一个网关，多个聊天平台&#10;&lt;/h3&gt;&lt;p&gt;Gateway 是 Hermes 和外界的连接点。这套部署启用了：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;飞书：日常主要入口，也是 home channel&lt;/li&gt;&#10;&lt;li&gt;Telegram：个人移动端入口&lt;/li&gt;&#10;&lt;li&gt;企业微信、微信：分别给其他 Profile 使用&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;api_server&lt;/code&gt; 和 &lt;code&gt;webhook&lt;/code&gt;：供脚本或其他系统调用&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;不同平台的展示能力不一样，所以在 &lt;code&gt;display.platforms&lt;/code&gt; 中按平台单独调整，例如飞书和 Telegram 关闭中间过程消息，避免刷屏：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt;1&#10;&lt;/span&gt;&lt;span class="lnt"&gt;2&#10;&lt;/span&gt;&lt;span class="lnt"&gt;3&#10;&lt;/span&gt;&lt;span class="lnt"&gt;4&#10;&lt;/span&gt;&lt;span class="lnt"&gt;5&#10;&lt;/span&gt;&lt;span class="lnt"&gt;6&#10;&lt;/span&gt;&lt;span class="lnt"&gt;7&#10;&lt;/span&gt;&lt;span class="lnt"&gt;8&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;display&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;platforms&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;telegram&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;streaming&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;interim_assistant_messages&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;feishu&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;tool_progress&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;interim_assistant_messages&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;h3 id="角色层用-profile-隔离用途"&gt;角色层：用 Profile 隔离用途&#10;&lt;/h3&gt;&lt;p&gt;一个 Agent 同时承担开发、产品、测试、知识库问答和家庭事务，技能和记忆很容易互相干扰。Hermes 的 Profile 正好解决这个问题：每个 Profile 有自己的配置、技能集合和记忆。&lt;/p&gt;&#10;&lt;p&gt;除了默认的 &lt;code&gt;default&lt;/code&gt;，这里按用途又建了五个 Profile：&lt;code&gt;dev&lt;/code&gt;、&lt;code&gt;product&lt;/code&gt;、&lt;code&gt;tester&lt;/code&gt;、&lt;code&gt;kb&lt;/code&gt;、&lt;code&gt;home&lt;/code&gt;。比如 &lt;code&gt;home&lt;/code&gt; 只挂了最基础的技能，&lt;code&gt;kb&lt;/code&gt; 只保留知识库问答相关的技能。&lt;/p&gt;&#10;&lt;p&gt;配合 &lt;code&gt;gateway.multiplex_profiles: true&lt;/code&gt;，同一个网关进程就能同时服务所有 Profile。路由方式很简单：每个 Profile 持有自己的机器人凭证，消息从哪个机器人进来，就交给哪个 Profile 处理。&lt;/p&gt;&#10;&lt;h3 id="能力层skillsplugins-和-cron"&gt;能力层：Skills、Plugins 和 Cron&#10;&lt;/h3&gt;&lt;p&gt;能力层是 Hermes 可塑性最强的部分：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Skills&lt;/strong&gt;：以 &lt;code&gt;SKILL.md&lt;/code&gt; 为单位的能力包，按目录分类存放。内置技能很多，我禁用了大部分用不到的，减少提示词占用和误触发。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Plugins&lt;/strong&gt;：运行在网关进程里的 Python 扩展。我用了两个插件：一个社区插件在 &lt;code&gt;pre_gateway_dispatch&lt;/code&gt; 钩子里恢复按时间自动重置会话（上游在 &lt;code&gt;v2026.9.11&lt;/code&gt; 移除了这个能力），另一个是让 Hermes 自己写的本地补丁，让企业微信发送文件失败时回退到主动发送。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Cron&lt;/strong&gt;：Hermes 内置的定时任务。除了定时让 Agent 执行提示词，也可以直接运行 &lt;code&gt;scripts/&lt;/code&gt; 下的脚本，比如每天检查宿主机磁盘占用并告警。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;扩展篇会以这两个插件为例，讲 Hermes 插件的两种典型写法。&lt;/p&gt;&#10;&lt;h3 id="记忆与状态层让-agent-记住自己是谁"&gt;记忆与状态层：让 Agent 记住自己是谁&#10;&lt;/h3&gt;&lt;ul&gt;&#10;&lt;li&gt;&lt;code&gt;SOUL.md&lt;/code&gt;：Agent 的人设和说话风格，例如要求回答长度与问题分量匹配、不说客套话。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;memories/MEMORY.md&lt;/code&gt; 和 &lt;code&gt;memories/USER.md&lt;/code&gt;：长期记忆和用户画像，分别有 &lt;code&gt;2200&lt;/code&gt; 和 &lt;code&gt;1375&lt;/code&gt; 字符上限，逼着记忆保持精炼。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;state.db&lt;/code&gt;：会话、消息、全文检索等运行状态，启用了 WAL 模式。跑了几个月后已经涨到两百多 MB，需要关注清理和备份。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;session_reset&lt;/code&gt;：每天凌晨 4 点切换新会话，避免上下文无限增长（新版本需要插件配合才生效）。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="一条消息的完整路径"&gt;一条消息的完整路径&#10;&lt;/h2&gt;&lt;p&gt;把各层串起来，一条飞书消息大致经过这些步骤：&lt;/p&gt;&#10;&lt;pre class="mermaid" style="visibility:hidden"&gt;sequenceDiagram&#10; participant U as 用户（飞书）&#10; participant G as Gateway&#10; participant H as 插件钩子&#10; participant A as Agent（Profile）&#10; participant M as 主模型&#10; participant X as 辅助模型&#10;&#10; U-&gt;&gt;G: 发送消息&#10; G-&gt;&gt;H: pre_gateway_dispatch&#10; H--&gt;&gt;G: 必要时重置会话&#10; G-&gt;&gt;A: 路由到对应 Profile 的会话&#10; A-&gt;&gt;M: 携带 SOUL、记忆、技能提示调用模型&#10; M--&gt;&gt;A: 回复或工具调用&#10; A-&gt;&gt;A: 执行工具 / 技能，循环直到完成&#10; A-&gt;&gt;X: 上下文过长时压缩、生成标题&#10; A--&gt;&gt;G: 最终回复&#10; G--&gt;&gt;U: 按平台展示策略发送&lt;/pre&gt;&lt;h2 id="这套架构的边界"&gt;这套架构的边界&#10;&lt;/h2&gt;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;前提是内网&lt;/strong&gt;：Dashboard 只有 Basic Auth，审批模式也是关闭的（&lt;code&gt;approvals.mode: 'off'&lt;/code&gt;）。这套配置建立在服务器不对外暴露、使用者都可信的前提下。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;单容器单点&lt;/strong&gt;：所有能力都在一个容器里，容器出问题，所有渠道一起失效。对个人和小团队够用，但要接受这个单点。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;跟随 &lt;code&gt;latest&lt;/code&gt; 镜像&lt;/strong&gt;：升级方便，但上游行为变化会直接影响现有配置。会话重置能力被移除，就是一个真实例子。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="系列规划"&gt;系列规划&#10;&lt;/h2&gt;&lt;p&gt;后续文章按层展开：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;a class="link" href="https://www.iminling.com/ai/hermes/hermes-agent-docker-deployment/" &gt;部署篇&lt;/a&gt;：Docker Compose、s6 启动链、数据目录结构、Dashboard、升级与备份&lt;/li&gt;&#10;&lt;li&gt;&lt;a class="link" href="https://www.iminling.com/ai/hermes/hermes-agent-model-config/" &gt;模型篇&lt;/a&gt;：自定义 provider、主辅模型分工、上下文压缩与缓存、MoA&lt;/li&gt;&#10;&lt;li&gt;&lt;a class="link" href="https://www.iminling.com/ai/hermes/hermes-agent-gateway-profiles/" &gt;接入与 Profile 篇&lt;/a&gt;：多平台 Gateway、Profile 多路复用、会话划分与重置&lt;/li&gt;&#10;&lt;li&gt;&lt;a class="link" href="https://www.iminling.com/ai/hermes/hermes-agent-skills-plugins-cron/" &gt;扩展篇&lt;/a&gt;：Skills 管理、插件开发、Cron 脚本任务&lt;/li&gt;&#10;&lt;li&gt;&lt;a class="link" href="https://www.iminling.com/ai/hermes/hermes-agent-newapi-prompt-cache/" &gt;番外：提示词缓存排查&lt;/a&gt;：接入 New API 时 GPT、Grok、GLM、Claude 的缓存协议与逐层取证&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="总结"&gt;总结&#10;&lt;/h2&gt;&lt;p&gt;Hermes 的配置项很多，按层来看就清晰了：部署层保证常驻和数据持久，模型层决定成本和能力，接入层和角色层决定谁在什么场景下用它，能力层和记忆层决定它能做什么、记得什么。改一个配置之前先想清楚它属于哪一层，就不容易越改越乱。&lt;/p&gt;&#10;</description></item><item><title>Hermes Agent 部署篇：Docker Compose、数据目录与 Dashboard</title><link>https://www.iminling.com/ai/hermes/hermes-agent-docker-deployment/</link><pubDate>Thu, 19 Nov 2026 00:00:00 +0000</pubDate><guid>https://www.iminling.com/ai/hermes/hermes-agent-docker-deployment/</guid><description>&lt;img src="https://images.iminling.com/i/2026/11/19/04f2d7beb05632bf1f5678586439ea85.webp" alt="Featured image of post Hermes Agent 部署篇：Docker Compose、数据目录与 Dashboard" /&gt;&lt;h2 id="写在前面"&gt;写在前面&#10;&lt;/h2&gt;&lt;p&gt;这是 Hermes Agent 架构系列的第二篇，讲最底下的部署层。整体分层见 &lt;a class="link" href="https://www.iminling.com/ai/hermes/hermes-agent-architecture-overview/" &gt;Hermes Agent 自托管架构总览&lt;/a&gt;。&lt;/p&gt;&#10;&lt;p&gt;部署层要解决三件事：进程长期在线、数据不随容器丢失、有一个能看状态的管理界面。Hermes 官方镜像已经把大部分事情做好了，自己要做的主要是挂好数据目录、配好 Dashboard 认证。&lt;/p&gt;&#10;&lt;p&gt;本文环境：Hermes Agent &lt;code&gt;v0.23.0&lt;/code&gt;，官方镜像 &lt;code&gt;nousresearch/hermes-agent:latest&lt;/code&gt;，服务器在内网。&lt;/p&gt;&#10;&lt;h2 id="compose-配置"&gt;Compose 配置&#10;&lt;/h2&gt;&lt;p&gt;我的 &lt;code&gt;docker-compose.yaml&lt;/code&gt; 放在 &lt;code&gt;/usr/local/svc/hermes&lt;/code&gt;：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt; 1&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 2&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 3&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 4&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 5&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 6&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 7&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 8&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 9&#10;&lt;/span&gt;&lt;span class="lnt"&gt;10&#10;&lt;/span&gt;&lt;span class="lnt"&gt;11&#10;&lt;/span&gt;&lt;span class="lnt"&gt;12&#10;&lt;/span&gt;&lt;span class="lnt"&gt;13&#10;&lt;/span&gt;&lt;span class="lnt"&gt;14&#10;&lt;/span&gt;&lt;span class="lnt"&gt;15&#10;&lt;/span&gt;&lt;span class="lnt"&gt;16&#10;&lt;/span&gt;&lt;span class="lnt"&gt;17&#10;&lt;/span&gt;&lt;span class="lnt"&gt;18&#10;&lt;/span&gt;&lt;span class="lnt"&gt;19&#10;&lt;/span&gt;&lt;span class="lnt"&gt;20&#10;&lt;/span&gt;&lt;span class="lnt"&gt;21&#10;&lt;/span&gt;&lt;span class="lnt"&gt;22&#10;&lt;/span&gt;&lt;span class="lnt"&gt;23&#10;&lt;/span&gt;&lt;span class="lnt"&gt;24&#10;&lt;/span&gt;&lt;span class="lnt"&gt;25&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;services&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;hermes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;image&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;nousresearch/hermes-agent:latest&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;container_name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;hermes&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;restart&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;unless-stopped&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;network_mode&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;host&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;volumes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;./data:/opt/data&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;/data/work:/data/work:ro&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;environment&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;TZ=Asia/Shanghai&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="c"&gt;# Dashboard&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD=1&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_HOST=0.0.0.0&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_PORT=9119&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="c"&gt;# Dashboard 登录认证&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_BASIC_AUTH_USERNAME=&amp;lt;your-username&amp;gt;&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=&amp;lt;your-password&amp;gt;&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_BASIC_AUTH_SECRET=&amp;lt;random-secret&amp;gt;&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;command&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;gateway&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;run&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;p&gt;逐项说明：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;配置&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;作用&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;network_mode: host&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;网关、Dashboard、&lt;code&gt;api_server&lt;/code&gt; 直接用宿主机端口，不用逐个映射&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;./data:/opt/data&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;容器内 &lt;code&gt;HERMES_HOME&lt;/code&gt; 就是 &lt;code&gt;/opt/data&lt;/code&gt;，所有状态都落在宿主机&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/data/work:/data/work:ro&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;只读挂载工作目录，Agent 能读代码和资料，但改不了宿主机文件&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;TZ=Asia/Shanghai&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Cron 表达式和会话每日重置都按本地时间计算&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;HERMES_DASHBOARD=1&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;在同一个容器里顺带启动 Dashboard&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;command: [&amp;quot;gateway&amp;quot;, &amp;quot;run&amp;quot;]&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;容器以网关模式常驻，接收各聊天平台消息&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;和官方仓库里的 &lt;code&gt;docker-compose.yml&lt;/code&gt; 相比，主要区别有三点：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;官方示例是本地 &lt;code&gt;build&lt;/code&gt;，并挂载 &lt;code&gt;~/.hermes&lt;/code&gt;；我直接用发布的镜像，数据放在服务目录下，方便和其他服务统一管理。&lt;/li&gt;&#10;&lt;li&gt;官方示例通过 &lt;code&gt;HERMES_UID&lt;/code&gt; / &lt;code&gt;HERMES_GID&lt;/code&gt; 把容器内用户映射成宿主机用户。我没设置，容器内进程使用默认的 &lt;code&gt;10000&lt;/code&gt; 用户，所以宿主机上 &lt;code&gt;data/&lt;/code&gt; 的属主也是 &lt;code&gt;10000&lt;/code&gt;。&lt;/li&gt;&#10;&lt;li&gt;官方建议 Dashboard 只绑定 &lt;code&gt;127.0.0.1&lt;/code&gt;，远程访问走 SSH 隧道或带认证的反向代理。我的服务器只在内网，才直接监听 &lt;code&gt;0.0.0.0&lt;/code&gt; 并只加 Basic Auth。&lt;strong&gt;公网服务器不要照抄这一点。&lt;/strong&gt;&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="容器里是怎么启动的"&gt;容器里是怎么启动的&#10;&lt;/h2&gt;&lt;p&gt;镜像的入口是 &lt;code&gt;/opt/hermes/docker/entrypoint-dispatch.sh&lt;/code&gt;。它判断自己是不是 PID 1：正常 Docker 环境下会交给 s6-overlay 的 &lt;code&gt;/init&lt;/code&gt;，由 s6 负责后续的初始化和进程守护。&lt;/p&gt;&#10;&lt;pre class="mermaid" style="visibility:hidden"&gt;flowchart TB&#10; Dispatch[entrypoint-dispatch.sh] --&gt;|PID 1| Init[s6-overlay /init]&#10; Init --&gt; CI[cont-init.d：权限、Profile 校正]&#10; CI --&gt; Wrapper[main-wrapper.sh gateway run]&#10; Wrapper --&gt; Gateway[网关进程]&#10; Wrapper --&gt; Dashboard[Dashboard]&#10; Gateway -.崩溃后由 s6 拉起.-&gt; Gateway&lt;/pre&gt;&lt;p&gt;这条链路带来两个实际影响：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;不要随便覆盖 &lt;code&gt;entrypoint&lt;/code&gt;&lt;/strong&gt;。官方 compose 注释写得很明确：&lt;code&gt;/init&lt;/code&gt; 必须是第一条命令，它负责执行 &lt;code&gt;cont-init.d&lt;/code&gt; 中的权限修正、Profile 校正等初始化脚本。绕过它，网关不能正常工作。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;进程挂了不用手动重启&lt;/strong&gt;。网关由 s6 守护，异常退出会被重新拉起；&lt;code&gt;restart: unless-stopped&lt;/code&gt; 只负责整个容器层面的重启。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;用 &lt;code&gt;docker exec hermes ps aux&lt;/code&gt; 能看到 &lt;code&gt;s6-supervise&lt;/code&gt; 和以 &lt;code&gt;10000&lt;/code&gt; 用户运行的 Python 网关进程。&lt;/p&gt;&#10;&lt;h2 id="数据目录结构"&gt;数据目录结构&#10;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;/opt/data&lt;/code&gt;（宿主机上的 &lt;code&gt;./data&lt;/code&gt;）就是 Hermes 的全部家当。跑了三个月后，我的数据目录是 7.8G，主要构成如下：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;路径&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;体积&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;内容&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;cache/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2.8G&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;各类缓存，可以清理&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;profiles/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2.5G&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;每个 Profile 的独立数据，结构和根目录类似&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;skills/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;689M&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;默认 Profile 的技能&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;lazy-packages/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;456M&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;按需安装的 Python 依赖，例如语音识别用的 &lt;code&gt;faster_whisper&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;home/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;407M&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Agent 执行命令时的家目录&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;tools/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;267M&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;工具运行时，包括 Playwright 浏览器&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;state.db&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;259M&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;会话、消息、全文检索等核心状态（SQLite）&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;logs/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;30M&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;网关、Agent、错误日志&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;另外几个体积不大但很重要的文件：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;code&gt;config.yaml&lt;/code&gt;：主配置&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;.env&lt;/code&gt;：密钥和平台凭证，权限是 &lt;code&gt;600&lt;/code&gt;&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;SOUL.md&lt;/code&gt;：默认 Profile 的人设&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;memories/&lt;/code&gt;：长期记忆 &lt;code&gt;MEMORY.md&lt;/code&gt; 和用户画像 &lt;code&gt;USER.md&lt;/code&gt;&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;cron/jobs.json&lt;/code&gt;：定时任务定义&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;plugins/&lt;/code&gt;：插件&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;&lt;code&gt;state.db&lt;/code&gt; 使用 WAL 模式（&lt;code&gt;database.journal_mode: wal&lt;/code&gt;），所以旁边总会有 &lt;code&gt;state.db-wal&lt;/code&gt; 和 &lt;code&gt;state.db-shm&lt;/code&gt;。&lt;strong&gt;备份时不要只拷贝 &lt;code&gt;state.db&lt;/code&gt; 一个文件&lt;/strong&gt;，最好停容器后整体备份，或者用 SQLite 的在线备份命令。&lt;/p&gt;&#10;&lt;p&gt;排查问题时最常看的是 &lt;code&gt;logs/&lt;/code&gt; 下的这几个：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;code&gt;gateway.log&lt;/code&gt;：平台连接和消息收发&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;agent.log&lt;/code&gt;：对话和工具调用过程&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;errors.log&lt;/code&gt;：所有错误汇总&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="dashboard"&gt;Dashboard&#10;&lt;/h2&gt;&lt;p&gt;Dashboard 和网关跑在同一个容器里，由 &lt;code&gt;HERMES_DASHBOARD=1&lt;/code&gt; 打开。它能查看会话、模型用量、Cron 任务和配置，日常检查很方便。&lt;/p&gt;&#10;&lt;p&gt;认证使用 Basic Auth，需要三个环境变量：用户名、密码和用于签发登录态的 &lt;code&gt;SECRET&lt;/code&gt;。首次启动后，&lt;code&gt;config.yaml&lt;/code&gt; 的 &lt;code&gt;dashboard.basic_auth&lt;/code&gt; 里只会保存密码哈希，不保存明文。&lt;/p&gt;&#10;&lt;p&gt;Dashboard 能看到所有对话和配置，它的暴露范围要和这些数据的敏感程度相匹配。&lt;/p&gt;&#10;&lt;h2 id="备份与升级"&gt;备份与升级&#10;&lt;/h2&gt;&lt;p&gt;Hermes 在修改配置时会自动留存快照，位置在 &lt;code&gt;backups/config/&lt;/code&gt;，文件名类似 &lt;code&gt;config.yaml.good.20261118-100122&lt;/code&gt;。改坏配置后可以从这里找回上一个能用的版本。&lt;/p&gt;&#10;&lt;p&gt;升级相关配置：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt;1&#10;&lt;/span&gt;&lt;span class="lnt"&gt;2&#10;&lt;/span&gt;&lt;span class="lnt"&gt;3&#10;&lt;/span&gt;&lt;span class="lnt"&gt;4&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;updates&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;pre_update_backup&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;backup_keep&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="m"&gt;5&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;non_interactive_local_changes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;stash&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;p&gt;用 Docker 部署时，升级就是拉取新镜像后重建容器：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt;1&#10;&lt;/span&gt;&lt;span class="lnt"&gt;2&#10;&lt;/span&gt;&lt;span class="lnt"&gt;3&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nb"&gt;cd&lt;/span&gt; /usr/local/svc/hermes&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;docker compose pull&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;docker compose up -d&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;p&gt;我跟的是 &lt;code&gt;latest&lt;/code&gt; 标签，升级方便，但要接受上游行为变化直接生效。比如 &lt;code&gt;v2026.9.11&lt;/code&gt; 移除了按时间自动切换会话的能力，升级后配置还在，功能却没了（后来用插件补回来了，见扩展篇）。重要环境建议固定版本标签，升级前先看更新说明。&lt;/p&gt;&#10;&lt;p&gt;我的做法是手动升级：想升级时执行上面两条命令，升级前不额外备份 &lt;code&gt;data/&lt;/code&gt;。数据目录挂载在宿主机上，重建容器不会删除它；配置改坏了，还可以从 &lt;code&gt;backups/config/&lt;/code&gt; 的快照里找回。&lt;/p&gt;&#10;&lt;h2 id="踩坑不需要自建镜像装浏览器"&gt;踩坑：不需要自建镜像装浏览器&#10;&lt;/h2&gt;&lt;p&gt;最早我以为官方镜像没有浏览器，写了一个 &lt;code&gt;Dockerfile&lt;/code&gt; 基于官方镜像安装 Chromium 和中文字体：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt;1&#10;&lt;/span&gt;&lt;span class="lnt"&gt;2&#10;&lt;/span&gt;&lt;span class="lnt"&gt;3&#10;&lt;/span&gt;&lt;span class="lnt"&gt;4&#10;&lt;/span&gt;&lt;span class="lnt"&gt;5&#10;&lt;/span&gt;&lt;span class="lnt"&gt;6&#10;&lt;/span&gt;&lt;span class="lnt"&gt;7&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-dockerfile" data-lang="dockerfile"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;FROM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;nousresearch/hermes-agent:latest&lt;/span&gt;&lt;span class="err"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;USER&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;root&lt;/span&gt;&lt;span class="err"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;RUN&lt;/span&gt; apt-get update &lt;span class="se"&gt;\&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; apt-get install -y --no-install-recommends &lt;span class="se"&gt;\&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; chromium chromium-driver fonts-noto-cjk &lt;span class="se"&gt;\&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; rm -rf /var/lib/apt/lists/*&lt;span class="err"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;USER&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;hermes&lt;/span&gt;&lt;span class="err"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;p&gt;后来发现完全多余：官方镜像已经内置 Playwright，容器里设置了 &lt;code&gt;PLAYWRIGHT_BROWSERS_PATH&lt;/code&gt;，浏览器放在数据目录的 &lt;code&gt;tools/playwright-browsers&lt;/code&gt; 下，Agent 的浏览器工具开箱即用。&lt;/p&gt;&#10;&lt;p&gt;自建镜像的代价也很实在：每次上游更新都要重新构建，&lt;code&gt;docker compose pull&lt;/code&gt; 拉不到新版本。现在 compose 里直接使用官方镜像，那个 Dockerfile 已经弃用。&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;结论：先确认官方镜像里有没有，再决定要不要自己构建。&lt;/strong&gt; 检查方法：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt;1&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;docker &lt;span class="nb"&gt;exec&lt;/span&gt; hermes sh -c &lt;span class="s1"&gt;&amp;#39;echo $PLAYWRIGHT_BROWSERS_PATH; ls $PLAYWRIGHT_BROWSERS_PATH&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;h2 id="总结"&gt;总结&#10;&lt;/h2&gt;&lt;ul&gt;&#10;&lt;li&gt;部署只需要一个容器：官方镜像 + 数据目录挂载 + &lt;code&gt;gateway run&lt;/code&gt;。&lt;/li&gt;&#10;&lt;li&gt;s6 负责初始化和进程守护，不要覆盖入口。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;/opt/data&lt;/code&gt; 就是全部状态，备份它，并注意 &lt;code&gt;state.db&lt;/code&gt; 的 WAL 文件。&lt;/li&gt;&#10;&lt;li&gt;Dashboard 很好用，但认证和暴露范围要自己把关。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;下一篇讲模型层：怎么接入自建的模型网关，以及如何按任务给主模型和辅助模型分工。&lt;/p&gt;&#10;</description></item></channel></rss>