大模型应用开发 / 系统课时
部署 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日志内容应显示服务成功监听端口。如果出现权限错误,需要调整挂载目录权限后重新启动。
按自己的节奏,确认真正理解。