가장 흔한 경우는 서비스가 완전히 중단되었는데 URL이 /v1 없거나, Hermes 8642가 작동하지 않거나, 호스트가 도커에서 localhost로 작성되어 있는 경우입니다. 공식 Open WebUI 문서에는 이 세 가지 포인트가 문제 해결 영역에 직접 포함되어 있으니, 여기서 가장 빠른 부분을 확인해 보겠습니다.
최소 문제 해결 절차
- Open WebUI 연결 주소가 단순히
:8642가 아니라http://host.docker.internal:8642/v1인지 확인하세요. curl http://localhost:8642/health를 네이티브로 실행하여 Hermes API 서버가 정상 작동 중인지 확인하세요.curl http://localhost:8642/v1/models후에는hermes-agent이나 프로필 이름을 정상적으로 볼 수 있을 것입니다.- Open WebUI가 Docker에서 실행된다면, Hermes 주소를 컨테이너 내
localhost로 쓰지 말고host.docker.internal,--network=host, 또는 브리지 IP를 사용하세요.
여기서 쉽게 갇히는 거죠
Open WebUI의 연결 테스트가 통과할 수 있다고 해서 모델 목록이 자동으로 꺼지는 것은 아닙니다. 연결 테스트는 "이 주소가 API처럼 보이는가"와 비슷하며, 모델 드롭다운도 올바른 콘텐츠를 반환하기 위해 /v1/models에 의존합니다.
한마디로: 모델 드롭다운 박스가 비어 있으니 Open WebUI를 먼저 재설치하지 마세요. 우선적으로 Hermes 8642 /v1가 듣고 있는지, 그리고 컨테이너가 호스트 주소에 어떻게 접근하는지 점검하세요.
공식 오픈 소스 주소: https://github.com/NousResearch/hermes-agent; 공식 문서 입력: https://hermes-agent.nousresearch.com/.
