Hermes 에이전트는 도커 브라우저 도구에서 실패하며, Node.js 버전, 브라우저 의존성, 컨테이너 권한, 디스플레이 환경에 집중합니다. 채팅 가용성이 있다고 해서 브라우저 자동화가 가능하다는 의미는 아니며, 브라우저 링크는 추가적인 시스템 의존성을 필요로 합니다.
먼저 근본적인 의존성을 확인하세요
공식 설치 문서에는 Hermes가 Node.js v22, ripgrep, ffmpeg 등과 같은 컴포넌트에 의존한다고 명시되어 있습니다. 브라우저 자동화와 WhatsApp 브리징은 특히 Node 생태계에 의존합니다. 이미지가 아직 오래된 노드라면, 명확한 '버전이 잘못됐다'는 대신 깊은 의존성 오류가 발생할 수 있습니다.
컨테이너 내 흔한 원인
- 미러에는 브라우저 런북이 없어 Playwright/Chromium이 실행에 실패합니다.
- 컨테이너 보안 정책은 샌드박스를 제한하며, 이미지 설명에 따라 권한을 설정해야 합니다.
- 작업 디렉터리가 제대로 마운트되지 않아 브라우저가 파일을 다운로드하거나 상태를 저장하지 못합니다.
- 네트워크 프록시는 호스트 머신에서만 설정되어 있고, 웹 페이지 컨테이너 접근이 실패합니다.
권장 조사 방법
먼저 컨테이너로 가서 최소한의 브라우저 테스트를 수행하세요. Hermes가 복잡한 웹 작업을 직접 실행하게 하지 마세요. 노드, 브라우저, 네트워크가 모두 정상인지 확인한 후 Hermes 작업으로 돌아가세요. 로그에서 브라우저, 크로미움, 샌드박스, 공유 라이브러리 관련 오류가 보인다면, 기본적으로 컨테이너 환경 문제입니다.
운영 환경에서는 브라우저 기능과 일반 채팅 기능을 별도로 수용하는 것이 권장됩니다: 채팅 패스, 툴 패스, 브라우저 패스, 파일 마운트 패스 등 각 계층은 별도로 테스트되어 후속 에이전트 작업이 중간에 멈추지 않도록 합니다.
