阿里云在部署Hermes有哪些需要避坑之处？

本文由云枢国际yunshuguoji撰写；以下三处是部署避坑的核心。
1、内存避坑
Hermes Agent 对内存很敏感，1GB 实例必崩，2GB 是最低底线，跑技能或多轮对话建议直接上 4GB。
致命坑：选 1GB 轻量服务器，启动后几秒就 OOM 崩溃，日志报 “memory exhausted”。
正确做法：
1.轻量应用服务器选2 核 2GB 起步，生产环境优先 2 核 4GB。
2.内存不足时临时救急：配置 4GB SWAP 分区，避免运行中自动退出。
镜像直接选阿里云市场自带的Hermes Agent 应用镜像，预配置依赖，减少编译内存消耗。

2、阿里云安全组 + 服务器防火墙双重限制，漏放一个端口就导致服务不可用，核心端口就 3 个。

避坑步骤：
1.控制台→轻量服务器→防火墙→一键放行 18789、8080 端口，协议选 TCP。
2.系统内部关闭端口占用：执行sudo lsof -i:18789，杀掉占用进程，避免端口冲突。
网关启动失败时，直接改配置：编辑~/.hermes/config.yaml，更换端口为 18790，重启服务即可。

3、API 配置避坑 地域匹配 + 密钥正确
高频坑点：
1.地域错位：服务器选国内（非香港），API Key 选海外地域，直接报 “invalid api key”。
2.密钥不完整：复制时漏了末尾字符，或用了过期 Key。
3.网络受限：国内服务器默认屏蔽模型接口，联网搜索、技能调用全失败。

一次搞定配置：
1.地域统一：服务器选香港 / 海外地域，百炼 API Key 同地域创建，避开国内地域网络限制。
2.获取密钥：百炼控制台→密钥管理→创建 API Key（sk - 开头），立即复制保存，页面刷新不可查。
3.一键配置：SSH 连接服务器，执行hermes config set DASHSCOPE_API_KEY "你的密钥"，自动写入环境变量。
防超额：订阅百炼 Coding Plan，开启 “用完即停”，避免 Token 账单暴增。