使用 Docker 安装 Qdrant

Qdrant 提供了官方 Docker 镜像，使得安装和运行变得非常简单。以下是使用 Docker 安装和运行 Qdrant 的详细步骤：

1. 前提条件

  • 已安装 Docker 和 Docker Compose
  • 确保系统满足 Qdrant 的资源要求（建议至少 4GB 内存）

2. 快速启动（单机模式）

最简单的启动方式是使用官方镜像直接运行：

docker pull qdrant/qdrant
docker run -p 6333:6333 -p 6334:6334 \-v $(pwd)/qdrant_storage:/qdrant/storage \qdrant/qdrant

这个命令会：

  • 拉取最新版 Qdrant 镜像
  • 映射 6333 (HTTP API) 和 6334 (gRPC) 端口
  • 将数据持久化到主机上的 qdrant_storage 目录

3. 使用 Docker Compose（推荐）

对于更复杂的配置，建议使用 Docker Compose：

  1. 创建 docker-compose.yml 文件：
version: '3.8'services:qdrant:image: qdrant/qdrantports:- "6333:6333"- "6334:6334"volumes:- ./qdrant_storage:/qdrant/storagerestart: unless-stopped
  1. 启动服务：
docker-compose up -d

4. 验证安装

访问以下 URL 验证 Qdrant 是否正常运行：

  • http://localhost:6333 - 应该返回 Qdrant 的欢迎页面
  • http://localhost:6333/collections - 检查集合列表（初始应为空）

5. 高级配置

可以通过环境变量或配置文件进行更多配置：

services:qdrant:image: qdrant/qdrantports:- "6333:6333"- "6334:6334"volumes:- ./qdrant_storage:/qdrant/storage- ./config.yaml:/qdrant/config/production.yamlenvironment:- QDRANT__SERVICE__GRPC_PORT=6334- QDRANT__CLUSTER__ENABLED=falserestart: unless-stopped

6. 停止和清理

停止服务：

docker-compose down

删除数据（如果需要）：

rm -rf qdrant_storage

注意事项

  1. 生产环境建议：
  • 启用认证
  • 配置资源限制
  • 考虑使用集群模式
  1. 数据目录 qdrant_storage 包含了所有持久化数据，请确保定期备份
  2. 默认配置适合开发和测试，生产环境需要根据负载调整配置参数