docker 安装 Qdrant 向量数据库

Qdrant 是一款基于 Rust 语言开发的开源向量数据库与向量相似度搜索引擎，遵循 Apache 2.0 许可，专为 AI 和机器学习场景中高维向量的高效存储、检索及管理而设计，常作为语义搜索、推荐系统等应用的核心支撑组件。

你可以通过使用 Python 的 qdrant-client 库开始使用 Qdrant，或者拉取最新的 qdrant Docker 镜像并在本地连接，或者尝试使用Qdrant Cloud 的免费层选项，直到你准备好完全切换为止。

下面为你详细介绍如何通过 Docker 安装 Qdrant 向量数据库。

前提条件

在安装 Qdrant 之前，需要确保你的系统已经安装了 Docker 和 Docker Compose。你可以通过以下命令来验证：

docker --version
docker-compose --version

如果你的系统尚未安装它们，可以参考下面文档进行安装：

• Docker 安装指南

• Docker Compose 安装指南

安装步骤

1. 创建配置目录

首先，我们需要创建一个目录来存放 Qdrant 的配置文件和数据：

root@localhost:~# mkdir -p qdrant/config qdrant/storage
root@localhost:~# cd qdrant/
root@localhost:~/qdrant# ls
config  storage

2. 配置 Docker Compose 文件

在 qdrant 目录下面创建一个名为 docker-compose.yml 的文件，如下：

root@localhost:~/qdrant# ls
config  docker-compose.yml  storage

docker-compose.yml 文件内容如下：

version: '3.8'
services:
  qdrant:
    image: qdrant/qdrant:v1.5.1
    container_name: qdrant
    ports:
      - "6333:6333"  # 用于 HTTP API
      - "6334:6334"  # 用于 gRPC API
    volumes:
      - ./storage:/qdrant/storage
      - ./config:/qdrant/config
    restart: always
    environment:
      - QDRANT__STORAGE__STORAGE_PATH=/qdrant/storage
      - QDRANT__SERVICE__HTTP_PORT=6333

注意：你可以根据实际需求调整端口映射和存储路径。

3. 启动 Qdrant 服务

使用 docker-compose up -d 命令启动 Qdrant 服务，如下：

root@localhost:~/qdrant# docker-compose up -d
Pulling qdrant (qdrant/qdrant:v1.5.1)...
v1.5.1: Pulling from qdrant/qdrant
360eba32fa65: Pull complete
565de4317f00: Pull complete
3e88aa578d3c: Pull complete
01a117370059: Pull complete
53a2b2515334: Pull complete
d06a598de5a3: Pull complete
72c02f393bbf: Pull complete
4f4fb700ef54: Pull complete
Digest: sha256:26db04f374b707a4c4655cd81ec24aa096a5d9bd280cf3f8bd6f3e3ca3e133cc
Status: Downloaded newer image for qdrant/qdrant:v1.5.1
Creating qdrant ... done

执行该命令后，Docker 会下载 Qdrant 镜像并启动容器。你可以通过以下命令查看容器的运行状态：

root@localhost:~/qdrant# docker ps | grep qdrant
4ff6e44fd08b   qdrant/qdrant:v1.5.1   "./entrypoint.sh"        22 seconds ago   Up 22 seconds   0.0.0.0:6333-6334->6333-6334/tcp, [::]:6333-6334->6333-6334/tcp   qdrant

4. 验证安装

Qdrant 启动后，你可以通过以下命令验证其是否正常运行：

root@localhost:~/qdrant# curl http://localhost:6333/collections
{"result":{"collections":[]},"status":"ok","time":0.00001235}

或者，通过浏览器访问 http://localhost:6333/collections 地址，如果安装成功，将会看见下图：

停止和卸载

如果你需要停止 Qdrant 服务，可以使用以下命令：

root@localhost:~/qdrant# docker-compose down
Stopping qdrant ... done
Removing qdrant ... done
Removing network qdrant_default

如果你希望彻底删除 Qdrant 及其数据（请谨慎操作，数据将无法恢复），可以使用以下命令：

# 停止 Qdrant 服务
root@localhost:~/qdrant# docker-compose down
Stopping qdrant ... done
Removing qdrant ... done
Removing network qdrant_default

# 查看 Qdrant 服务的持久化目录
root@localhost:~/qdrant# ll storage/
total 20
drwxr-xr-x 4 root root 4096 Nov 24 10:57 ./
drwxr-xr-x 4 root root 4096 Nov 24 10:47 ../
drwxr-xr-x 2 root root 4096 Nov 24 10:57 aliases/
drwxr-xr-x 2 root root 4096 Nov 24 10:57 collections/
-rw-r--r-- 1 root root  299 Nov 24 10:57 raft_state.json

# 递归删除持久化目录数据，彻底卸载，谨慎操作，该步骤不可逆
root@localhost:~/qdrant# rm -rf ./storage

Qdrant 启动后，你可以通过 HTTP API 或 gRPC API 与其交互。Qdrant 官方提供了多种编程语言的客户端库，包括 Python、JavaScript、Go 等，方便你在应用中集成向量数据库功能。