FAQ¶
자주 묻는 질문과 답변입니다.
설치 및 배포¶
원클릭 설치 스크립트 다운로드에 실패하나요?¶
서버의 외부 네트워크 연결을 확인하세요. 중국 내 네트워크 환경이라면 먼저 Docker 이미지 가속기를 설정할 수 있습니다.
포트가 이미 사용 중이면 어떻게 하나요?¶
설치 스크립트 또는 컨테이너 오케스트레이션의 포트 매핑을 수정하거나, 해당 포트를 점유한 서비스를 중지하세요. 주요 포트: 8010, 9090, 9093, 8500, 4505/4506.
admin 비밀번호를 잊어버리면 어떻게 하나요?¶
호스트 관리¶
스크립트 실행 시 호스트를 선택할 수 없는 이유는 무엇인가요?¶
스크립트 실행, 파일 배포, 예약 작업은 관리 중인 호스트만 선택할 수 있습니다. 먼저 「호스트 관리」에서 호스트가 「관리 중」 목록에 있는지 확인하세요(관리 대기 중인 호스트는 선택할 수 없습니다).
OpsMini 호스트가 계속 「관리 대기 중」 상태인가요?¶
Agent가 보고했지만 승인되지 않은 상태입니다. 「호스트 관리 - 관리 대기 중」으로 이동하여 「관리 승인」을 클릭하세요.
Token 검증에 실패하나요?¶
Agent의 Token이 플랫폼과 일치하지 않습니다. Agent 설정 파일의 server_token이 「시스템 설정 - 연동 Token」과 일치하는지 확인하세요.
모니터링 및 알람¶
알람 이벤트에 데이터가 없나요?¶
- 「시스템 설정 - Prometheus 연동」 설정이 올바른지 확인
- Prometheus 주소에 접근 가능한지, Basic Auth 자격 증명이 올바른지 확인
- 호스트가 관리 중이며 Consul에 등록되었는지 확인
AI 어시스턴트¶
모델 가져오기에 실패하나요?¶
API Key가 올바른지, Base URL에 접근 가능한지 확인하세요. DeepSeek는 embeddings 인터페이스를 지원하지 않으며(chat completions만 지원), 지식 베이스 벡터화에는 다른 서비스를 별도로 설정해야 합니다.
기타¶
플랫폼 접근 시 502 오류가 발생하나요?¶
로컬에서 프록시를 통해 접근할 때 프록시를 경유하여 502가 발생할 수 있습니다. 직접 연결을 시도하거나 --noproxy을(를) 설정하세요.