Hermes Agent Dashboard 打不开,先确认你安装了 web 额外依赖,再检查端口和绑定地址。官方 CLI 参考里说明 Dashboard 默认运行在 127.0.0.1:9119,用于管理配置、API Key 和会话。
先看启动方式
直接运行 hermes dashboard,默认会尝试打开浏览器。如果服务器没有桌面环境,可以用 hermes dashboard --no-open,再通过 SSH 隧道或反向代理访问。
常见原因和处理
- 提示缺少 FastAPI 或 Uvicorn:安装带 web extras 的 Hermes 依赖。
- 端口被占用:改用
hermes dashboard --port 8080。 - 远程服务器访问不了:默认只绑定
127.0.0.1,不要误以为公网能直接打开。 - 浏览器自动打开失败:加
--no-open后手动访问地址。
不要直接暴露到公网
Dashboard 涉及配置和密钥管理,不建议把 host 改成公网地址后裸奔。更好的做法是用 SSH 隧道、本机访问、VPN 或带认证的反向代理。临时排查可以先本机确认功能正常,再处理远程访问层。
如果 Dashboard 启动成功但页面空白,继续看终端输出和 hermes logs,一般能看到依赖、端口、权限或前端资源加载错误。