Hermes Agent 跨平台部署实战：从 $5 VPS 到容器化一次跑通-编程实验室

Hermes Agent 跨平台部署实战：从 $5 VPS 到容器化一次跑通

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent

Hermes Agent 是 Nous Research 的自改进 AI 代理，支持本地、Docker、SSH、Modal、Daytona 等 7 种终端后端，还带学习闭环和定时任务。这篇文章带你从空环境到跑通 Hermes Agent 部署，覆盖单机、容器化和资源受限三种场景，附常见排错速查。

🧭 适用场景与选型速览

Hermes Agent 的核心特性是"不绑死在某台机器上"：同一个 agent 核心跑在 CLI、TUI、消息网关和桌面端上，终端命令在哪个 backend 执行由你决定。选型时只看三个问题：你要不要 7×24 运行、要不要隔离、要不要为空闲时间省钱。

部署形态	典型硬件	适合谁
本机安装	笔记本 / 台式机	边开发边试 agent 的人
轻量 VPS 常驻	1～2 核、$5/月级别	要 7×24 收 Telegram 消息、跑 cron 的人
Docker 容器	任意 Linux 主机	要隔离环境、多实例、版本可控回滚的人
Modal / Daytona serverless	按需付费，空闲休眠	低频调用、不想为闲置买单的人

先按这张表定方向，再走下面的最小路径。

🚀 最小可用路径：5 分钟跑通

在 Linux / macOS / WSL2 上，这一行会装好uv、Python、Node.js 等全部依赖，统一落到~/.hermes：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.bashrc # 重新加载 shell 让 hermes 命令生效 hermes setup # 配置向导：模型、密钥、工具一次配完

Windows 原生支持（无需 WSL2），在 PowerShell 里换装法：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Windows 安装落在%LOCALAPPDATA%\hermes，会自动带一个便携版 Git Bash 用于跑 shell 命令。装完后常用入口就这几个：hermes进入对话，hermes model切模型（支持 OpenRouter、OpenAI、自定义端点等），hermes tools勾选启用的工具，hermes gateway启动消息网关。

⚙️ 按场景深入

单机轻量跑通：VPS 常驻 + 消息网关

适合把 agent 挂在低价 VPS 上长期驻留：你在 Telegram 里发条消息，它就在服务器上干活，还能配 cron 做日报、夜间备份。

hermes gateway setup # 配置平台凭据（以 Telegram 为例） hermes gateway start # 启动网关，之后从 Telegram 直接对话

⚠️ 换模型、换工具集都会使对话的 prompt 缓存失效，token 成本会明显上升；想控制上下文长度用/compress，而不是中途反复改配置。

容器化部署：Docker 多实例

仓库根目录的Dockerfile已把依赖、前端构建和 SQLite 全部固化好，构建后直接用。下面这条命令是最小可运行的容器：

docker run -d --name hermes \ -v hermes-data:/opt/data \ -e HERMES_MODEL=provider:model \ <hermes-image> gateway

/opt/data是唯一需要挂出来的数据卷（会话、记忆、配置都在这），镜像里的代码目录是只读的，容器重建不丢状态。

⚠️ 别用docker exec <容器> bash以 root 身份写数据卷里的文件，产物会变成 root 属主，受监管的 gateway 进程（UID 10000）就读不回去了。

资源受限与 serverless：Modal / Daytona 按需唤醒

机器配置低或调用不频繁时，把终端后端切到 Modal 或 Daytona：环境空闲时休眠、来消息再唤醒，账单接近于零。配合一个更便宜的小模型（hermes model切换）就是完整的低成本方案，README 官方口径是 "$5 VPS 或 GPU 集群都能跑"。

hermes config set terminal.backend modal hermes doctor # 配置变更后跑一遍自检

⚠️ serverless 后端每次唤醒都有冷启动，几秒级延迟；对响应时间敏感的会话建议常驻 VPS 或容器。

🔍 排错与调优速查

装完提示command not found：当前 shell 没加载新 PATH →source ~/.bashrc（zsh 则source ~/.zshrc）。
Windows 杀软隔离了uv.exe：误报，这是 Astral 的 Python 包管理器 → 按文件夹白名单%LOCALAPPDATA%\hermes\bin，不要按文件哈希，hermes update后哈希会变。
docker exec后改的配置 gateway 读不到：root 写出的文件属主不对 → 用docker exec --user hermes执行写操作。
记忆 / 会话搜索功能异常：Debian 13 自带 SQLite 3.46.1 有上游 WAL 损坏 bug → 用官方容器镜像，它内置了修复版 SQLite。
token 消耗突然变高：中途换过模型或工具集，prompt 缓存失效 → 长对话里保持配置稳定，必要时用/usage核对。