🐳 绿联 NAS 部署原生 Hermes Agent 完整指南
把应用中心封装版换成 Nous Research 官方原生版，告别更新慢、配置受限、装死问题。
📌 为什么要换？
绿联应用中心里那个 Hermes Agent 是**封装版**：
- ❌ 版本滞后
- ❌ 配置项被限制，providers/MCP/技能目录改不了
- ❌ 升级要等绿联打包
- ❌ 出问题没法 debug（数据目录藏在 `/volume1/@appdata`）
换成**原生 Docker 版**后：
- ✅ `hermes update` 一行升级
- ✅ 所有数据归你管（一份 `docker-compose.yml` 走天下）
- ✅ Portainer 统一管理
- ✅ 想加 provider / MCP / 技能随便改
更新最新Hermes Agent Compose-yaml 配置文件描述 （2026-06-11 09:33:15）
针对应用中心无法及时同步更新Hermes Agent官方内核应用问题，Docker部署原生HermesAgent可以得以解决。
1.进入应用中心卸载封装的hermesagent 应用

2.通过docker 应用-项目-创建 hermes agent 项目
compose-yaml：

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes
    restart: unless-stopped
    command:
        gateway run
    ports:
      - "8642:8642"   # gateway API
      - "9119:9119"   # dashboard（仅在 HERMES_DASHBOARD=1 时生效）   
    volumes:
      - ./data:/opt/data
      - /volume2/Music:/volume2/Music #允许hermes agent访问的NAS盘符
      - /volume3/Document:/volume3/Document
    environment:
      - HERMES_DASHBOARD=1 #默认启动dashborad应用
      - HERMES_DASHBOARD_INSECURE=1
      - PATH=/opt/hermes/.venv/bin:/usr/local/bin:/usr/bin:/bin
      - HERMES_EXTRA_PIP_PACKAGES=aiohttp httpx python-dotenv
      - TZ=Asia/Shanghai
      - HERMES_ALLOW_ROOT_GATEWAY=1
    deploy:
      resources:
        limits:
          memory: 8G
          cpus: "2.0"


3.使用portainer 管理docker应用




部署portainer 使用docker进行部署（部署方式可参照我主页部署portainer的主题帖子）

4.等待容器下载完成后，自动创建容器 。进入hermes-agent


5.访问9119的dashborad端口，验证配置应用是否能打开。



部署完你能拿到：
- 🆕 **永远最新** — `hermes update` 一键升
- 🗄 **数据全在自己手上** — `docker compose down` 干净撤退
- 🔌 **Portainer 统一管** — 跟 NAS 其他容器一起看
- 🧩 **技能/MCP 自由加** — 不被封装版绑死
有问题贴日志到 **GitHub Issues** 或 **Hermes 社区** 🛟
📦 配套资源：
- 🔗 Hermes Agent 官方仓库 → https://github.com/NousResearch/hermes-agent
- 📖 完整文档 → https://hermes-agent.nousresearch.com/docs
- 💬 社区讨论 → GitHub Discussions

萌面大虾 发表于 2026-6-11 15:21
大佬，您好。请问安装第三步3.使用portainer 管理docker应用 作用是什么呢？是必须安装的吗 ...

针对有安装过官方hermes agent处理废弃卷用的。

萌面大虾 发表于 2026-6-11 15:21
大佬，您好。请问安装第三步3.使用portainer 管理docker应用 作用是什么呢？是必须安装的吗 ...

非必需。

大佬，您好。请问安装第三步3.使用portainer 管理docker应用 作用是什么呢？是必须安装的吗

uLZNd6 发表于 2026-6-11 11:53
求助，按这样配置后，hermes启起来了，但是挂载documents没有读写权限，为什么呢 ...

使用root用户  用SSH连接nas，查看documents的文件夹权限

求助，按这样配置后，hermes启起来了，但是挂载documents没有读写权限，为什么呢

NU6Gsl 发表于 2026-6-2 13:57
你们用docker上的hermes都做什么 我部署了 但是不知道让他干嘛好

让他干活。

后续带来Hermes Agent使用反爬浏览器camofox的配置教程

部署portainer可参考：https://club.ugnas.com/forum.php ... tid=4750&extra=

rcVJzk 发表于 2026-5-25 17:41
不卸载可以部署多一个吗

可以，不同名，不同路径就可以