Chuyển đến nội dung

qdrant / qdrant

Qdrant

Cơ sở dữ liệu vector viết bằng Rust, chạy bằng một lệnh Docker, mạnh về lọc và tìm kiếm lai

Qdrant (đọc là quadrant) là cơ sở dữ liệu vector và công cụ tìm kiếm tương đồng: lưu các điểm gồm vector kèm dữ liệu đi kèm (payload) rồi tìm những điểm gần nghĩa nhất, có thể lọc theo điều kiện. Nó dùng để làm bộ nhớ cho hỏi đáp tài liệu (RAG), tìm kiếm ngữ nghĩa, gợi ý và tìm ảnh giống nhau, có máy chủ tự cài lẫn bản đám mây.

  • 35.579 sao
  • 2.820 fork
  • Rust
  • Cập nhật hôm qua
  • Apache 2.0 (dùng tự do, kể cả thương mại)
Độ khó
Khó Dành cho người biết lập trình
Dạng
Web tự cài (self-host), Thư viện lập trình
Chạy trên
Docker, Linux, macOS, Windows, Python
Chi phí
Miễn phí, có bản trả phí

Trải nghiệm khi dùng Qdrant

Bạn bắt đầu với Qdrant bằng đúng một lệnh Docker: kéo ảnh qdrant/qdrant và mở cổng 6333. Khi container chạy, bạn có sẵn một máy chủ vector trên máy mình, kèm REST API và giao diện web để xem các collection, quản lý dữ liệu và thử gọi API. Việc tiếp theo là dùng thư viện khách (Python, JavaScript/TypeScript, Go, Rust, Java, .NET) để kết nối.

Cách dùng điển hình: bạn dùng một mô hình nhúng (embedding) biến câu chữ hay ảnh thành vector, lưu vào Qdrant cùng thông tin như tên nguồn, ngày đăng, danh mục. Khi người dùng hỏi, bạn đổi câu hỏi thành vector và nhờ Qdrant trả về các điểm gần nhất, đồng thời lọc theo điều kiện như 'chỉ trong tài liệu năm nay' hay 'chỉ thuộc phòng kinh doanh'.

Ngoài chế độ máy chủ, Qdrant có Edge, bản chạy ngay trong tiến trình ứng dụng cho thiết bị nhỏ, và dịch vụ Qdrant Cloud có gói miễn phí nếu bạn không muốn tự vận hành. Khi triển khai thật, README nhắc kỹ phải đọc hướng dẫn cài đặt và bảo mật.

Tính năng nổi bật

Vector dày, thưa và đa vector

Hỗ trợ tìm theo ý nghĩa, tìm theo từ khoá bằng vector thưa và các mô hình nhiều vector như ColBERT.

Lọc theo payload

Gắn JSON vào từng điểm và lọc theo từ khoá, khoảng số, vị trí địa lý với các điều kiện must, should, must_not.

Tìm kiếm lai

Kết hợp nhiều truy vấn trong một lần và trộn kết quả bằng các chiến lược như RRF hay DBSF.

Nén vector và lưu trên đĩa

Lượng tử hoá giúp giảm mạnh dung lượng RAM (README nêu tối đa 97%), đổi lại bạn cân bằng giữa tốc độ và độ chính xác.

Phân tán và nhiều khách hàng

Mở rộng theo chiều ngang bằng sharding, replication và chia dữ liệu theo từng khách.

Giao diện web và nhiều thư viện khách

Có Web UI để xem dữ liệu, REST/gRPC API và thư viện chính thức cho Go, Rust, JS/TS, Python, .NET, Java.

Tận dụng Qdrant vào việc gì?

Lập trình viên, đội AI

Bộ nhớ cho chatbot hỏi đáp tài liệu

Lưu các đoạn tài liệu đã nhúng và truy xuất đúng đoạn liên quan trước khi nhờ AI trả lời.

Shop online, sàn thương mại điện tử

Tìm sản phẩm giống nhau theo ảnh hoặc mô tả

Cho khách tải ảnh hoặc gõ mô tả để gợi ý các sản phẩm gần nhất trong danh mục.

Trang tin, nền tảng học tập

Gợi ý bài viết, khoá học liên quan

Dùng chức năng gợi ý bằng ví dụ tích cực và tiêu cực để đề xuất nội dung phù hợp.

Sinh viên, người mới học AI

Học làm tìm kiếm ngữ nghĩa

Làm theo các demo và khoá học Qdrant Essentials để hiểu cách vector hoạt động.

Cần chuẩn bị gì?

  • Docker để chạy máy chủ bằng lệnh dưới đây; ngoài ra có tuỳ chọn cài khác trong tài liệu chính thức.
  • Một thư viện khách (ví dụ qdrant-client cho Python) và một mô hình nhúng để tạo vector.
  • RAM và ổ đĩa tuỳ lượng dữ liệu và cách lưu; có thể giảm bằng nén vector và lưu trên đĩa.
  • Nếu mở ra mạng, cần cấu hình xác thực và bảo mật theo tài liệu.

Hướng dẫn cài đặt chi tiết

Cài trên Docker

  1. Cài Docker (Docker Desktop trên Windows, macOS) rồi mở Terminal hoặc PowerShell và chạy lệnh chính thức của README. Lệnh này mở cổng 6333.

    Terminal
    docker run -p 6333:6333 qdrant/qdrant
  2. Lưu ý: README nói rõ đây là cấu hình không xác thực và mở cho mọi giao diện mạng. Chỉ dùng để thử trên máy cá nhân; trước khi đưa lên môi trường thật hãy đọc hướng dẫn cài đặt và bảo mật của Qdrant.

  3. Muốn dữ liệu còn sau khi tắt container, đọc hướng dẫn cài đặt để gắn thư mục lưu trữ (volume) vào container.

Cài trên Python (khách)

  1. Cài thư viện khách Python vào môi trường ảo.

    Terminal
    pip install qdrant-client
  2. Kết nối tới máy chủ đang chạy.

    Python
    from qdrant_client import QdrantClient
    
    client = QdrantClient(url="http://localhost:6333")

Dùng thử lần đầu

  1. Khởi động máy chủ bằng lệnh Docker ở trên và để cửa sổ đó chạy.

  2. Mở giao diện web của Qdrant theo hướng dẫn trong tài liệu để xem các collection khi bạn tạo chúng.

  3. Kết nối bằng Python và tạo một collection, rồi thêm vài điểm có vector và payload; cách làm từng bước nằm ở Quick Start Guide trong tài liệu chính thức.

  4. Thử tìm kiếm có lọc theo payload, ví dụ chỉ lấy điểm thuộc một danh mục.

  5. Muốn học có hệ thống, làm theo khoá Qdrant Essentials hoặc hướng dẫn tạo công cụ tìm kiếm ngữ nghĩa mà README liên kết tới.

Mẹo dùng hay

  • Quyết định mô hình nhúng trước: số chiều vector phải khớp với collection, đổi mô hình sau này đồng nghĩa với nhúng lại dữ liệu.
  • Dùng payload và bộ lọc để thu hẹp kết quả thay vì để AI tự lọc sau, vừa nhanh vừa chính xác hơn.
  • Với dữ liệu lớn, thử lượng tử hoá và lưu trên đĩa để giảm RAM, nhưng đo kết quả thật trên dữ liệu của bạn.

Lưu ý và hạn chế

  • Lệnh Docker nhanh trong README tạo máy chủ không xác thực; đừng để nó ra Internet mà chưa bật bảo mật.
  • Đây là hạ tầng cho lập trình viên chứ không phải ứng dụng người dùng cuối; bạn cần tự xây phần ứng dụng bên trên.
  • Hiệu năng và chi phí tuỳ dữ liệu; các so sánh benchmark của nhà phát triển cần được kiểm chứng trên dữ liệu thật của bạn.

Câu hỏi thường gặp

Qdrant có miễn phí không?

Máy chủ mã nguồn mở theo Apache 2.0 và tự cài thì miễn phí. Qdrant Cloud là dịch vụ quản lý trả phí và README nói có gói miễn phí.

Khác gì Milvus hay Chroma?

Cả ba đều là cơ sở dữ liệu vector. Qdrant nổi bật ở lọc theo payload và chạy máy chủ gọn bằng Rust; Chroma nhẹ, dễ thử cho người mới; Milvus hướng tới quy mô rất lớn. Nên thử với dữ liệu thật của bạn.

Máy tính cá nhân chạy được không?

Được cho dữ liệu nhỏ đến vừa: chỉ cần Docker. Khi dữ liệu lớn, RAM trở thành yếu tố chính, bạn có thể dùng nén vector để giảm.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/qdrant/qdrant.git

Repo tương tự nên xem

Tài liệu, OCR & hỏi đáp tri thức46,7K

Milvus

milvus-io / milvus

Cơ sở dữ liệu vector mã nguồn mở để tìm kiếm theo ý nghĩa trên văn bản, hình ảnh ở quy mô lớn

KhóLinuxmacOSDockerPython
Tài liệu, OCR & hỏi đáp tri thức29,7K

Chroma

chroma-core / chroma

Cơ sở dữ liệu vector mã nguồn mở dễ nhất để bắt đầu: cài bằng pip, dùng bốn hàm là chạy

VừaPythonNode.jsDocker
Tài liệu, OCR & hỏi đáp tri thức94,2K

RAGFlow

infiniflow / ragflow

Nền tảng tự cài giúp AI trả lời dựa trên tài liệu của bạn, có trích dẫn nguồn.

VừaDockerLinuxWeb

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Tài liệu, OCR & hỏi đáp tri thức

Tài liệu, OCR & hỏi đáp tri thức196K

MarkItDown

microsoft / markitdown

Công cụ của Microsoft đổi PDF, Word, Excel, PowerPoint và nhiều file khác thành Markdown cho AI đọc.

VừaWindowsmacOSLinuxPython
Tài liệu, OCR & hỏi đáp tri thức96,8K

Stirling PDF

Stirling-Tools / Stirling-PDF

Bộ hơn 50 công cụ PDF: gộp, tách, ký, che thông tin, nén, OCR, chạy trên máy hoặc tự cài.

DễWindowsmacOSLinuxDocker+1
Tài liệu, OCR & hỏi đáp tri thức92,7K

PaddleOCR

PaddlePaddle / PaddleOCR

Bộ công cụ OCR của Baidu: đọc chữ trong ảnh, PDF và đổi tài liệu thành Markdown hoặc JSON.

KhóWindowsmacOSLinuxPython
Tài liệu, OCR & hỏi đáp tri thức83,7K

MinerU

opendatalab / MinerU

Đọc PDF, ảnh scan và file Office rồi xuất Markdown, giữ bảng, công thức và bố cục phức tạp.

VừaWindowsmacOSLinuxDocker+1
Tài liệu, OCR & hỏi đáp tri thức77,5K

Tesseract OCR

tesseract-ocr / tesseract

Bộ máy nhận dạng chữ (OCR) mã nguồn mở đọc chữ từ ảnh scan, hỗ trợ hơn 100 ngôn ngữ

VừaWindowsmacOSLinux
Tài liệu, OCR & hỏi đáp tri thức70,6K

Docling

docling-project / docling

Chuyển PDF, Word, PowerPoint, Excel, HTML thành Markdown hoặc JSON gọn gàng để đưa cho AI đọc

VừaWindowsmacOSLinuxPython

Xem cả 22 repo Tài liệu, OCR & hỏi đáp tri thức Về Kho Repo