概述
hermes dashboard 启动 Hermes Agent 的 Web 仪表盘，用于管理配置、API 密钥、会话和内嵌聊天。你可以自定义绑定的主机/端口、跳过 UI 构建、运行隔离的按配置服务器，或控制正在运行的服务器。
hermes dashboard [register] [选项]子命令
register — 注册自托管仪表盘
hermes dashboard register向 Nous Portal 注册一个自托管仪表盘，并将 OAuth 客户端 ID 写入 .env。
选项
| 选项 | 说明 |
|---|---|
--port PORT |
监听端口。默认为 9119；传 0 由操作系统自动分配。 |
--host HOST |
绑定主机。默认为 127.0.0.1。 |
--insecure |
已弃用 / 无操作。 自 2026 年 6 月安全加固后，公开绑定不再能通过此选项禁用认证；公开绑定始终需要认证提供方。如需本地访问，请绑定 127.0.0.1 并通过隧道连接。 |
--skip-build |
跳过 Web UI 构建步骤，直接提供已有的 dist/。适用于 Windows 计划任务、CI 等非交互式环境。预先构建： cd web && npm run build。 |
--isolated |
从命名配置启动时，运行一个专属于该配置的服务器，而不是附加到机器级服务器。默认行为是统一的。 |
--stop |
停止所有正在运行的 Hermes Web 服务器进程并退出。 |
--status |
列出所有正在运行的 Hermes Web 服务器进程并退出。 |
--no-open |
不自动打开浏览器。 |
常见场景
本地启动仪表盘
hermes dashboard在 http://127.0.0.1:9119 启动仪表盘，并自动打开浏览器。
使用自定义端口
hermes dashboard --port 8080当 9119 端口被占用时使用。
启动时不打开浏览器
hermes dashboard --no-open适用于远程主机或通过脚本运行。
在 CI 中提供预构建 UI
cd web && npm run build
cd ..
hermes dashboard --skip-build --no-open在无头环境中使用 --skip-build，避免调用 npm。
查看或停止运行中的服务器
hermes dashboard --status
hermes dashboard --stop运行隔离的按配置仪表盘
hermes dashboard --isolated --profile work为 work 配置运行专用仪表盘服务器，而不是共享机器级服务器。
提示
- 当绑定到非回环地址时，仪表盘需要认证；请先设置 OAuth 或密码提供方。
- 仅本地使用时保持默认
127.0.0.1绑定，并通过 SSH 隧道进行远程访问。 --skip-build仍需要有效的dist/目录；使用前请先构建 UI。