1. 群晖上跑 Hermes 与 WebUI为什么卡在“Key 与配置”这一步Hermes 是 Nous Research 开源的一套 AI 助手框架支持工具调用、多轮会话和技能扩展Hermes WebUI 则是它的网页前端让你在浏览器里直接和 Agent 交互。把这两个东西塞进群晖 NAS 的 Docker 里好处很直接NAS 常年开机、数据落在本地卷、局域网内随时访问适合做个人知识库问答、代码辅助和自动化任务。适合谁有 DSM 7.x、装了 Docker 套件、内存 4GB 起步想跑大模型建议 8GB 以上的群晖用户。但真正动手时多数人不是倒在docker-compose up而是倒在后面Hermes 要连外部模型 APIWebUI 要读 Agent 状态两个容器共享配置目录Key 写在哪、config.toml骨架长什么样、怎么确认通道真的通了——这些没人讲清楚就会出现“容器都 Up网页打开一片空白”的尴尬。这篇就按“从零部署 → 统一 Key 接入 → 连通性自检”的顺序走一遍所有片段可直接复制路径按/volume2/docker/hermes举例你按自己存储卷改。核心检索词先摆明群晖 Docker 部署 Hermes、Hermes WebUI 配置、TaoToken 统一 Key、config.toml 骨架、curl 验证 API 连通性。下面每一步都围绕这几个词展开保证你能复现。2. 前置准备目录、镜像与 TaoToken 统一 Key2.1 建目录别让数据跟着容器一起没群晖的 Docker 容器删了数据就没了所以第一步永远是把卷映射到存储池。SSH 登录群晖后执行mkdir -p /volume2/docker/hermes/data mkdir -p /volume2/docker/hermes/home mkdir -p /volume2/docker/hermes/src mkdir -p /volume2/docker/hermes/workspace四个目录分工data放 Agent 工作数据与模型缓存home持久化配置/技能/会话src挂源码方便 WebUI 装依赖workspace是 WebUI 里能直接操作的文件区。先跑一次初始化容器生成配置docker run -it --rm \ -v /volume2/docker/hermes/data:/opt/data \ nousresearch/hermes-agent setup这一步会在data里生成初始配置文件后面config.toml就基于它改。2.2 TaoToken 统一 Key一个通道管住所有模型调用Hermes 支持 OpenAI、Anthropic 等外部 API但每个服务商一套 Key、一套端点管理起来很碎。TaoToken 提供统一 Key 与 API 通道你只需要在配置里写一个 base_url 和一个 Key模型切换在服务端完成NAS 这边不用改代码。对群晖这种“配置一次就想长期不动”的场景特别合适。先去控制台创建 Key访问 https://taotoken.net/api-keys deep link 已带 utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite生成后复制保存。API 基础地址用 https://taotoken.net/api 这个地址不加 UTM。想先确认模型是否可用可以到模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 试一条消息通了再往 NAS 里写。注意Key 只存在 NAS 本地配置文件里不要提交到任何公开仓库也不要在截图里露出完整字符串。3. 可复制配置docker-compose 与 config.toml 骨架3.1 docker-compose.yml 完整片段在/volume2/docker/hermes下新建docker-compose.ymlversion: 3.8 services: hermes-agent: image: nousresearch/hermes-agent:latest container_name: hermes-agent volumes: - /volume2/docker/hermes/home:/root/.hermes - /volume2/docker/hermes/data:/opt/data environment: - HERMES_HOME/root/.hermes restart: unless-stopped shm_size: 1gb deploy: resources: limits: memory: 4096M command: gateway run hermes-webui: image: ghcr.io/nesquena/hermes-webui:latest container_name: hermes-webui depends_on: - hermes-agent ports: - 8787:8787 volumes: - /volume2/docker/hermes/home:/home/hermeswebui/.hermes - /volume2/docker/hermes/src:/home/hermeswebui/.hermes/hermes-agent - /volume2/docker/hermes/workspace:/workspace environment: - HERMES_WEBUI_HOST0.0.0.0 - HERMES_WEBUI_PORT8787 - HERMES_WEBUI_STATE_DIR/home/hermeswebui/.hermes/webui-mvp - WANTED_UID1026 - WANTED_GID100 restart: unless-stopped关键点两个容器共享home目录WebUI 才能读到 Agent 的状态shm_size: 1gb给推理留共享内存memory: 4096M按你实际模型大小调跑大模型直接上 8192M。WANTED_UID/GID要和宿主机目录属主匹配否则写不进去。3.2 config.toml 骨架把 TaoToken 通道写进去Hermes 的配置目录在home下编辑/volume2/docker/hermes/home/config.toml若 setup 生成的是config.yaml按同结构迁移字段即可。骨架如下[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model gpt-4o-mini timeout 120 [agent] home /root/.hermes workspace /workspace max_turns 20 [webui] host 0.0.0.0 port 8787 state_dir /home/hermeswebui/.hermes/webui-mvpprovider用openai-compatible是因为 TaoToken 走标准 OpenAI 协议Hermes 直接兼容base_url填https://taotoken.net/api不要带路径后缀model换成你在模型对话页确认可用的名字。改完保存重启容器cd /volume2/docker/hermes docker-compose up -d docker-compose logs -f hermes-agent日志里出现 gateway 监听、无鉴权报错就说明配置被读进去了。4. 验证请求用 curl 确认 TaoToken 通道真的通容器 Up 不等于通道通。最稳的自检是绕过 Hermes直接用 curl 打 TaoToken 的接口确认 Key 和网络没问题curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: ping}] }返回 JSON 里带choices字段和一段回复内容说明 Key 有效、通道可达。如果返回 401是 Key 写错或没带Bearer返回 404检查base_url是不是多写了/v1或少写了超时则看群晖 DNS 和出网是否正常。通道确认后再验证 Hermes 内部是否用上了它。进 Agent 容器docker exec -it hermes-agent sh curl -s http://localhost:8787/healthWebUI 侧返回健康状态后浏览器打开http://你的群晖IP:8787在对话框发一条消息。能收到回复就说明“群晖 Docker → Hermes → TaoToken 通道 → 模型”整条链路打通了。这一步是整个部署里最有成就感的验证点建议截图存一份返回结构方便以后排障对照。5. 本篇常见错排查端口、权限、内存、Key端口冲突8787 被占时把 compose 里改成8888:8787同时config.toml的port保持容器内 8787 不变只改宿主机映射。权限问题WebUI 写不进 workspace多半是 UID/GID 不匹配。执行sudo chown -R 1026:100 /volume2/docker/hermes再重启容器。群晖用户 UID 常见是 1026用id命令确认自己的。内存不足跑大模型时容器被 OOM kill日志里会有Killed。把memory提到 8192Mshm_size提到2gb并确认群晖物理内存够。Key 相关报错401 查 Key 拼写和Bearer前缀403 查 Key 是否被禁用模型名不存在会返回 model not found回模型对话页核对准确名称。改完config.toml一定要docker-compose restart hermes-agent配置不会热加载。WebUI 空白页先看docker-compose logs -f hermes-webui多数是state_dir路径没权限或 Agent 没起来depends_on只保证启动顺序不保证 Agent 就绪等 10 秒再刷新。6. 后续怎么走把统一 Key 用在长期编码与 Agent 场景部署完只是起点。如果你打算把 Hermes 当长期编码助手或跑自动化 Agent建议把 Key 管理收敛到 TaoToken 的 Coding Plan统一额度与模型切换省得每个工具配一套https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入细节和字段说明看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。官网入口 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后给个实测经验群晖重启后容器自启没问题但home目录如果放在机械盘上WebUI 首次加载会慢几秒把配置目录挪到 SSD 缓存卷会顺很多。配置改完先 curl 再开网页能省掉一半“到底哪层坏了”的排查时间。