Hermesエージェントダッシュボードは起動しないので、追加のウェブ依存関係をインストールしているか確認し、ポートアドレスとバインディングアドレスを確認してください。公式CLIリファレンスによると、ダッシュボードはデフォルトで127.0.0.1:9119上で動作し、設定、APIキー、セッションの管理に使われています。
まずはスタートアップ方法を見てみましょう
hermes dashboardを直接実行すると、デフォルトでブラウザを開こうとします。サーバーにデスクトップ環境がない場合は、hermes dashboard --no-openを使い、SSHトンネルやリバースプロキシ経由でアクセスできます。
一般的な原因と治療
- FastAPIやUvicornが欠けているプロンプト:WebのエクストラでHermes依存をインストール。
- ポート占有:代わりに
hermes dashboard --port 8080を使え。 - リモートサーバーにはアクセスできません:デフォルトでバインドされているのは
127.0.0.1のみなので、公共ネットワークを直接開けると誤解しないでください。 - ブラウザの自動開きに失敗:
--no-openを追加した後に手動でアドレスにアクセスしました。
公開ネットワークに直接情報を漏らさないでください
ダッシュボードは設定と鍵管理を含み、ホストをパブリックアドレスに変更して裸で動作させるのは推奨されません。SSHトンネル、ローカルアクセス、VPN、または認証付きのリバースプロキシを利用するのが望ましいです。一時的なトラブルシューティングで、リモートアクセス層を扱う前にマシンが正常に動作しているか確認できます。
ダッシュボードは正常に起動してもページが空白の場合は、端末の出力やhermes logsを引き続き確認し、依存関係、ポート、権限、フロントエンドのリソース読み込みエラーなどが一般的に確認できます。
