返回AI问答
Hermes Agent Dashboard 打不开怎么排查?

Hermes Agent Dashboard 打不开怎么排查?

AI问答 Admin 492 次浏览

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,一般能看到依赖、端口、权限或前端资源加载错误。

推荐工具

更多