大模型应用开发 / 系统课时

部署 Qdrant 向量库

部署 Qdrant 向量库

本课介绍如何快速部署 Qdrant 向量数据库,为 RAG 系统提供向量存储和相似度检索能力。你将通过 Docker 完成启动、持久化配置以及连接验证,得到一个可继续接入应用的向量服务。

学习目标

  • 掌握使用 Docker 启动 Qdrant 服务的方法。
  • 理解向量数据库持久化目录配置。
  • 学会验证 Qdrant 服务状态和客户端连接。

Qdrant 在 RAG 架构中的位置

Qdrant 用于保存嵌入模型生成的向量,并根据用户查询向量返回最相似的文档片段。它不负责生成向量,而是负责高效管理和检索已有向量数据。

部署时需要重点关注服务端口、数据目录和运行状态。生产环境中必须配置持久化存储,避免容器删除后丢失索引数据。

使用 Docker 启动 Qdrant

下面示例创建一个本地 Qdrant 服务,将数据目录映射到宿主机。<PATH> 表示实际持久化路径,需要替换为真实目录。

bash
docker run -d \
  --name qdrant \
  -p <PORT>:6333 \
  -v <PATH>:/qdrant/storage \
  qdrant/qdrant

预期输出

text
<CONTAINER_ID>

返回容器 ID 表示 Docker 已创建并启动 Qdrant 容器。

验证服务状态

启动后可以检查容器运行状态,并通过健康接口确认服务是否可访问。

bash
docker ps --filter name=qdrant
curl http://localhost:<PORT>/healthz

预期结果

text
CONTAINER ID   IMAGE           STATUS
<CONTAINER_ID> qdrant/qdrant   Up

{"title":"healthz check passed"}

如果健康检查失败,优先确认端口是否被占用、容器日志是否存在启动错误,以及宿主机目录是否具有写权限。

配置数据持久化

Qdrant 的索引和向量数据保存在存储目录中。通过 Docker Volume 或目录映射,可以让容器生命周期与数据生命周期分离。

重新创建容器时,只要挂载相同目录,原有集合和向量数据仍然可以恢复。

常见部署问题排查

端口无法访问时,先检查容器状态和端口映射。容器正常运行但接口失败时,需要查看 Qdrant 日志。

bash
docker logs qdrant

预期结果

text
Qdrant service started
Listening on port 6333

日志内容应显示服务成功监听端口。如果出现权限错误,需要调整挂载目录权限后重新启动。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

部署 Qdrant 向量库

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通