문제가 생겼어요

설치·기동

  • docker compose ps에 wisdombase-docparser가 unhealthy — 첫 부팅 1~2분은 정상이에요. 계속되면 docker compose logs docparser에서 license 줄을 확인하세요. license/license.json이 없거나 다른 파일이면 파서가 부팅하지 않아요.
  • wisdombase-embedder가 unhealthy — 모델(models/embed.gguf, 약 640MB)을 읽는 중이에요. 느린 디스크에선 2분 넘게 걸릴 수 있어요. 그 사이 올린 문서는 30분 안에 자동으로 다시 임베딩돼요.
  • 브라우저에 「연결이 비공개가 아닙니다」 — 자체 인증서라 그래요. 사내 CA 인증서를 caddy/certs/에 넣으면 사라져요.
  • 80/443 포트 충돌 — .env의 WB_HTTP_PORT·WB_HTTPS_PORT를 바꾸고 docker compose up -d.

가져오기·검색

  • 「사내 웹이 아닌 주소예요」 — URL 가져오기는 사설망과 허용 목록 호스트만 돼요. 관리 › 온프렘 › 「URL 가져오기를 허용할 사내 웹 호스트」에 추가하세요.
  • 스캔 PDF가 「글자가 없어요」 — 온프렘 판은 OCR이 없어요. 글자가 든 PDF로 다시 저장해 올려 주세요.
  • 문서는 들어왔는데 검색이 안 돼요 — 관리 › 온프렘 › 구성 요소에서 임베딩 서버가 「연결됨」인지 보세요. 임베딩은 부팅 직후 도움말 문서부터 순서대로 처리하니 몇 분 기다려 주세요.
  • 챗봇이 문장 대신 발췌만 줘요 — LLM이 연결돼 있지 않거나 응답이 4분을 넘겼어요. 관리 › 온프렘 › LLM 연결에서 「연결 시험」을 눌러 보세요. CPU만 있으면 경량 팩을 쓰거나 답변 대기 시간을 .env의 WB_LLM_TIMEOUT_MS로 늘릴 수 있어요.

외부 통신

  • 「최근 차단된 외부 통신」에 호스트가 쌓여요 — 설계대로 막힌 거예요. 필요한 호스트면 허용 목록에 넣고, 아니면 무시하면 돼요.
  • 사내 LLM 주소가 공인 도메인이라 연결 시험은 되는데 답변이 안 돼요 — 저장하면 LLM 주소는 자동 허용되지만, 리다이렉트되는 다른 호스트가 있으면 그 호스트도 허용 목록에 적어 주세요.

그래도 안 풀리면

docker compose logs --tail 200 wisdombase 결과와 관리 › 온프렘 화면 캡처를 support@wisdombase.ai로 보내 주세요. 라이선스 ID(WB-…)를 같이 적어 주시면 빨라요.