Qdrant

​

어디에 쓰이나요?

• RAG (Retrieval-Augmented Generation): 문서를 임베딩으로 변환하여 저장하고, 사용자 질문과 유사한 문서를 검색하여 LLM에 전달
• 시맨틱 검색: 키워드 일치가 아닌, 의미가 비슷한 문서를 검색 (예: “강아지”로 검색하면 “반려견”, “puppy” 관련 문서도 검색)
• 추천 시스템: 사용자가 본 상품과 유사한 상품 추천
• 이미지 검색: 이미지를 벡터로 변환하여 비슷한 이미지 검색

​

Docker Compose

services:
  qdrant:
    image: qdrant/qdrant:latest
    container_name: qdrant
    restart: unless-stopped
    ports:
      - "6333:6333"
      - "6334:6334"
    volumes:
      - qdrant_data:/qdrant/storage

volumes:
  qdrant_data:

​

실행

docker compose up -d

​

접속 확인

curl http://localhost:6333/healthz

OK

​

기본 정보

​

API 키 설정

services:
  qdrant:
    image: qdrant/qdrant:latest
    container_name: qdrant
    restart: unless-stopped
    ports:
      - "6333:6333"
      - "6334:6334"
    environment:
      - QDRANT__SERVICE__API_KEY=your-api-key-here
    volumes:
      - qdrant_data:/qdrant/storage

volumes:
  qdrant_data:

curl -H "api-key: your-api-key-here" http://localhost:6333/healthz

​

환경 변수

​

라이선스

​

참고

• Qdrant Docker 설치 가이드
• Qdrant 공식 문서

​

설치 점검 목록

• docker compose up -d 후 docker compose ps로 컨테이너 상태를 확인했습니다.
• 기본 포트/계정/비밀번호를 문서대로 점검했습니다.
• 운영용으로 사용할 때 기본 비밀번호/시크릿 값을 변경했습니다.
• 장애 분석을 위해 docker compose logs -f 확인 방법을 숙지했습니다.

​

문제 해결 가이드

• 컨테이너가 실행되지 않으면 docker compose logs -f로 오류 원인을 먼저 확인합니다.
• 포트 충돌이 나면 기존 프로세스를 종료하거나 포트 매핑 값을 변경합니다.
• 이미지 pull 실패 시 네트워크 연결 및 레지스트리 접근 권한을 확인합니다.
• 설정 변경 후 문제가 지속되면 docker compose down 후 다시 up -d로 재기동합니다.

​

관련 문서