安装要求

以下章节描述了部署 Qdrant 的要求。

CPU 和内存

CPU 和 RAM 的首选大小取决于：

• 向量数量
• 向量维度
• Payload (有效载荷) 及其索引
• 存储
• 复制
• 量化配置方式

我们的 云定价计算器 可以帮助您在没有有效载荷或索引数据的情况下估算所需资源。

支持的 CPU 架构

64 位系统

• x86_64/amd64
• AArch64/arm64

32 位系统

• 不支持

存储

对于持久化存储，Qdrant 要求对具有 POSIX 兼容文件系统 的存储设备进行块级访问。提供块级访问的网络系统（如 iSCSI）也是可以接受的。Qdrant 不支持网络文件系统（如 NFS）或对象存储系统（如 S3）。

如果您将向量卸载到本地磁盘，我们建议您使用固态驱动器 (SSD 或 NVMe)。

网络

每个 Qdrant 实例需要开放三个端口：

• 6333 - 用于 HTTP API，以及 监控 健康状况和指标端点
• 6334 - 用于 gRPC API
• 6335 - 用于 分布式部署

集群中的所有 Qdrant 实例必须能够：

• 通过这些端口相互通信
• 允许使用 Qdrant 的客户端连接到 6333 和 6334 端口。

安全

Qdrant 的默认配置可能无法满足所有场景下的安全需求。请参阅 我们的安全文档 以获取更多信息。

安装选项

根据您的需求，可以通过多种方式安装 Qdrant：

对于生产环境，您可以使用我们的 Qdrant Cloud，在我们的基础设施中进行全托管运行，或者在您的基础设施中使用混合云模式。

如果您想在自己的基础设施中运行 Qdrant（不连接任何云服务），我们建议使用我们的 Qdrant Private Cloud Enterprise Operator 将 Qdrant 安装在 Kubernetes 集群中。

对于测试或开发设置，您可以运行 Qdrant 容器或作为二进制可执行文件运行。我们还提供了用于在 Kubernetes 中轻松安装的 Helm Chart。

生产环境

Qdrant 云

您可以使用 Qdrant Cloud 搭建生产环境，它提供全托管的 Qdrant 数据库。它支持水平和垂直扩展、一键安装和升级、监控、日志记录，以及备份和灾难恢复。更多信息，请参阅 Qdrant Cloud 文档。

Qdrant Kubernetes Operator

作为我们 Qdrant Private Cloud 服务的一部分，我们为 Kubernetes 安装提供了 Qdrant Enterprise Operator。欲了解更多信息，请 使用此表格 与我们联系。

Kubernetes

您可以使用现成的 Helm Chart 在您的 Kubernetes 集群中运行 Qdrant。虽然可以使用 Helm Chart 在分布式配置中部署 Qdrant，但它在零停机升级、自动伸缩、监控、日志记录以及备份和灾难恢复方面的功能与 Qdrant Cloud 或 Qdrant Private Cloud Enterprise Operator 不同。您必须 自行 管理和配置这些功能。Helm Chart 的支持仅限于社区支持。

下表概述了 Qdrant Cloud 与 Helm Chart 之间的功能差异：

安装 Helm Chart

helm repo add qdrant https://qdrant.to/helm
helm install qdrant qdrant/qdrant

更多信息，请参阅 qdrant-helm README 文档。

Docker 和 Docker Compose

通常，我们建议在 Kubernetes 中运行 Qdrant，或在生产环境中使用 Qdrant Cloud。这使得配置具有高可用性、可扩展性、备份和灾难恢复功能的 Qdrant 集群变得更加容易。

不过，您也可以通过遵循 Docker 和 Docker Compose 开发章节中的设置说明，使用 Docker 和 Docker Compose 在生产环境中运行 Qdrant。此外，您必须确保：

• 为您的数据使用高性能的 持久化存储
• 为您的部署配置 安全设置
• 在多个节点上设置和配置 Qdrant 以实现高可用性的 分布式部署
• 为您的 Qdrant 集群设置负载均衡器
• 为您的数据创建 备份和灾难恢复策略
• 将 Qdrant 与您的 监控 和日志解决方案集成

开发

对于开发和测试，我们建议您在 Docker 中设置 Qdrant。我们还提供了不同的客户端库。

Docker

开始使用 Qdrant 进行测试或开发的最简单方法是运行 Qdrant 容器镜像。最新版本始终可在 DockerHub 上获得。

确保已安装并运行 Docker、Podman 或您选择的容器运行时。以下说明使用 Docker。

拉取镜像

docker pull qdrant/qdrant

在以下命令中，根据您的 Docker 配置修改 $(pwd)/path/to/data。然后使用更新后的命令运行容器：

docker run -p 6333:6333 \
    -v $(pwd)/path/to/data:/qdrant/storage \
    qdrant/qdrant

通过此命令，您将启动一个具有默认配置的 Qdrant 实例。它将所有数据存储在 ./path/to/data 目录中。

默认情况下，Qdrant 使用 6333 端口，因此您应该可以在 localhost:6333 看到欢迎消息。

要更改 Qdrant 配置，您可以覆盖生产环境配置：

docker run -p 6333:6333 \
    -v $(pwd)/path/to/data:/qdrant/storage \
    -v $(pwd)/path/to/custom_config.yaml:/qdrant/config/production.yaml \
    qdrant/qdrant

或者，您可以使用自己的 custom_config.yaml 配置文件：

docker run -p 6333:6333 \
    -v $(pwd)/path/to/data:/qdrant/storage \
    -v $(pwd)/path/to/custom_config.yaml:/qdrant/config/custom_config.yaml \
    qdrant/qdrant \
    ./qdrant --config-path config/custom_config.yaml

更多信息，请参阅 配置 文档。

Docker Compose

您也可以使用 Docker Compose 运行 Qdrant。

这是一个用于单节点 Qdrant 集群的自定义 compose 文件示例：

services:
  qdrant:
    image: qdrant/qdrant:latest
    restart: always
    container_name: qdrant
    ports:
      - 6333:6333
      - 6334:6334
    expose:
      - 6333
      - 6334
      - 6335
    configs:
      - source: qdrant_config
        target: /qdrant/config/production.yaml
    volumes:
      - ./qdrant_data:/qdrant/storage

configs:
  qdrant_config:
    content: |
      log_level: INFO

从源码编译

Qdrant 使用 Rust 编写，可以编译为二进制可执行文件。如果您需要为特定的处理器架构编译 Qdrant，或者不想使用 Docker，这种安装方法会很有帮助。

在编译之前，请确保已安装必要的库和 Rust 工具链。所需的库列表可在 Dockerfile 中找到。

使用 Cargo 构建 Qdrant

cargo build --release --bin qdrant

构建成功后，您可以在以下子目录中找到二进制文件：./target/release/qdrant。

客户端库

除了服务本身，Qdrant 还为不同的编程语言提供了多种客户端库。完整列表请参阅我们的 客户端库 文档。