阿里云代理商：阿里云部署 Hermes 避坑指南 端口、内存、API 一次搞定
想在阿里云上快速跑通 Hermes Agent？很多人第一步就栽在端口不通、内存爆满、API 调用失败上。其实只要抓准端口放行、内存底线、API 地域匹配这三个核心，新手也能一次部署成功，避开 90% 的常见坑。
一、内存避坑
Hermes Agent 对内存很敏感，1GB 实例必崩，2GB 是最低底线，跑技能或多轮对话建议直接上 4GB。
致命坑：选 1GB 轻量服务器，启动后几秒就 OOM 崩溃，日志报 “memory exhausted”。
正确做法：
- 轻量应用服务器选2 核 2GB 起步，生产环境优先 2 核 4GB。
- 内存不足时临时救急：配置 4GB SWAP 分区，避免运行中自动退出。
- 镜像直接选阿里云市场自带的Hermes Agent 应用镜像，预配置依赖，减少编译内存消耗。
二、端口避坑 3 个核心端口
阿里云安全组 + 服务器防火墙双重限制，漏放一个端口就导致服务不可用，核心端口就 3 个：
必放端口清单
| 端口 | 作用 | 坑点 |
| 22 | SSH 远程连接 | 默认放行，别误删规则 |
| 18789 | Hermes 通信端口（技能调用核心） | 不放通→技能安装失败、网关无响应 |
| 8080 | Web 控制台访问端口 | 不放通→浏览器打不开管理面板 |
避坑步骤：
- 控制台→轻量服务器→防火墙→一键放行 18789、8080 端口，协议选 TCP。
- 系统内部关闭端口占用：执行sudo lsof -i:18789，杀掉占用进程，避免端口冲突。
- 网关启动失败时，直接改配置：编辑~/.hermes/config.yaml，更换端口为 18790，重启服务即可。
三、API 配置避坑 地域匹配 + 密钥正确
Hermes 靠百炼 API 调用大模型，地域不匹配、密钥错误、网络不通是调用失败的三大元凶。
高频坑点：
- 地域错位：服务器选国内（非香港），API Key 选海外地域，直接报 “invalid api key”。
- 密钥不完整：复制时漏了末尾字符，或用了过期 Key。
- 网络受限：国内服务器默认屏蔽模型接口，联网搜索、技能调用全失败。
一次搞定配置：
- 地域统一：服务器选香港 / 海外地域，百炼 API Key 同地域创建，避开国内地域网络限制。
- 获取密钥：百炼控制台→密钥管理→创建 API Key（sk – 开头），立即复制保存，页面刷新不可查。
- 一键配置：SSH 连接服务器，执行hermes config set DASHSCOPE_API_KEY “你的密钥”，自动写入环境变量。
- 防超额：订阅百炼 Coding Plan，开启 “用完即停”，避免 Token 账单暴增。
阿里云部署 Hermes Agent，从来不是技术难题，而是细节活。避开内存、端口、API 这三大坑，10 分钟就能跑通服务，让 AI 智能体稳定在线，专注业务创新而非底层排查。
