Hermes 에이전트 대시보드가 열리지 않으니, 추가 웹 의존성을 설치했는지 확인한 후 포트와 바인딩 주소를 확인하세요. 공식 CLI 참고 자료에 따르면 대시보드는 기본적으로 127.0.0.1:9119에서 실행되며 구성, API 키, 세션 관리를 위해 사용됩니다.
먼저 스타트업 방식을 살펴보겠습니다
hermes dashboard을 직접 실행하면 기본적으로 브라우저를 열려고 시도합니다. 서버에 데스크톱 환경이 없다면, hermes dashboard --no-open 사용한 후 SSH 터널이나 리버스 프록시를 통해 접근할 수 있습니다.
일반적인 원인과 치료
- 프롬프트에 빠진 FastAPI나 Uvicorn: 웹 추가 요소로 Hermes 의존성을 설치하세요.
- 항구 점령:
hermes dashboard --port 8080를 대신 사용하세요. - 원격 서버에 접근할 수 없습니다: 기본적으로
127.0.0.1만 묶여 있으니, 공용 네트워크를 직접 열 수 있다고 오해하지 마세요. - 브라우저 자동 열기 실패:
--no-open추가한 후 수동으로 주소에 접근함.
공개 네트워크에 직접 노출하지 마세요
대시보드는 구성 및 키 관리를 포함하며, 호스트를 공개 주소로 변경한 후 그대로 실행하는 것은 권장되지 않습니다. SSH 터널, 로컬 접속, VPN 또는 인증 후 역프록시를 사용하는 것이 더 좋습니다. 임시 문제 해결을 통해 원격 액세스 계층을 처리하기 전에 기계가 정상 작동하는지 확인할 수 있습니다.
대시보드가 정상적으로 시작되었지만 페이지가 비어 있다면, 터미널 출력과 hermes logs을 계속 확인하면 일반적으로 의존성, 포트, 권한, 또는 프론트엔드 자원 로딩 오류를 확인할 수 있습니다.
