大连网站建媒体代发网站

        Qdrant 是一个高性能、开源的向量数据库，广泛用于语义搜索、推荐系统和 AI 应用场景。本文将手把手带你通过 Docker 快速安装最新版 Qdrant，并实现基本的持久化与 API 密钥保护。

🧠 什么是 Qdrant？

Qdrant 是一款基于 Rust 的向量数据库，支持高效的相似度搜索、稀疏/稠密向量混合查询，并且拥有 REST/gRPC API 接口，便于快速集成。

---

📦 安装方式选择

Qdrant 支持多种部署方式：

• ✅ Docker（推荐）

• ✅ 本地二进制（Rust 编译）

• ✅ Kubernetes（适合分布式集群）

本教程采用 Docker Compose，优雅、快速、跨平台。

---

🛠 环境准备

确保你已安装好：

• Docker

• Docker Compose

检查命令是否可用：

docker --version
docker-compose --version

---

🧾 docker-compose.yml 示例配置

新建一个目录，比如 qdrant-server/，创建 docker-compose.yml：

version: '3.8'
services:qdrant:image: qdrant/qdrant:latest  # 使用最新版本ports:- "127.0.0.1:6333:6333"  # 绑定到本机，增强安全volumes:- ./qdrant_storage:/qdrant/storage  # 本地持久化目录environment:QDRANT__SERVICE__API_KEY: "f9aB3vPZ7mLxUj6qRk11234W8nHtXeGc"QDRANT__CLUSTER__ENABLED: "false"restart: unless-stopped

✅ 提示：你可以用任意强度的字符串作为 API Key，上面的是随机生成的示例。

---

🚀 启动服务

在当前目录下运行：

docker-compose up -d qdrant

查看服务状态：

docker ps

访问 API 测试页面：

• 打开浏览器访问 http://127.0.0.1:6333

• 默认跳转到 /docs，可直接尝试交互式 REST API

---

🔐 如何使用 API Key

默认你设置了环境变量 QDRANT__SERVICE__API_KEY，那么每次访问需要在请求头中加入：

api-key: f9aB3vPZ7mLxUj6qRk11234W8nHtXeGc

Python 示例（使用 qdrant-client）：

from qdrant_client import QdrantClientclient = QdrantClient(host="localhost",port=6333,api_key="f9aB3vPZ7mLxUj6qRk11234W8nHtXeGc"
)

---

🧪 测试你的向量数据库

你可以在 Qdrant 的 Swagger 文档 /docs 页面中尝试：

• 创建 collection

• 插入向量

• 查询向量

或者使用 Postman / curl 模拟调用。

---

📁 数据持久化在哪里？

本地的 ./qdrant_storage 目录即为持久化数据目录（自己创建），所有 collection 和向量数据都保存在这里，即使容器重启也不会丢失。

---

📌 常用命令速查表

操作	命令
启动服务	docker-compose up -d qdrant
查看日志	docker-compose logs -f qdrant
停止服务	docker-compose stop qdrant
重启服务	docker-compose restart qdrant
删除容器	docker-compose rm -f qdrant

---

🔄 如何升级 Qdrant？

只需修改 image 为新的版本号或使用 latest，然后：

docker-compose pull qdrant
docker-compose up -d qdrant

---

📚 更多参考

• Qdrant 官网：https://qdrant.tech

• GitHub 项目：https://github.com/qdrant/qdrant

• 文档中心：https://qdrant.tech/documentation