跳转到正文

准备 Qdrant 服务器

要在知识存储中选择 Qdrant 作为驱动程序,必须先有可以访问的 Qdrant 服务器。SetFN 不会随附安装 Qdrant 服务器,因此本文介绍如何使用 Docker 自行准备。


开始之前

  • 在 SetFN 中保存连接设置需要 Workspace 管理员权限。
  • 需要用于运行 Qdrant 服务器的 Linux(Ubuntu)环境和管理员(sudo)权限。
  • 如果该环境尚未安装 Docker,请先安装。
  • SetFN 服务器必须能够通过网络访问此 Qdrant 服务器。

安装 Docker

以下是基于 Ubuntu 的 Docker 官方安装步骤。如果已安装 Docker,请跳过此步骤。

1. 更新软件包索引并安装所需软件包

sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

2. 将 Docker 仓库添加到 Apt 源

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

3. 安装 Docker 软件包

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

运行 Qdrant 容器

1. 创建 docker-compose.yml 文件

在要运行 Qdrant 的文件夹中创建 docker-compose.yml 文件,并输入以下内容。

services:
  qdrant:
    image: qdrant/qdrant:latest
    container_name: qdrant
    restart: unless-stopped
    ports:
      - "6333:6333"
      - "6334:6334"
    volumes:
      - ./qdrant_storage:/qdrant/storage

2. 运行容器

在同一文件夹中运行容器。

sudo docker compose up -d
  • image:要使用的 Qdrant 镜像和版本。latest 在每次重新拉取容器时都会变为最新版本,因此在生产环境中,建议固定为 Qdrant 发布页面中组织已验证的特定版本。如果使用公司内部镜像仓库作为镜像源,可以将此路径改为相应地址。
  • container_name、./qdrant_storage:容器名称和数据存储路径仅为示例,可以改为所需的值。
  • 6333:REST API(HTTP)端口。
  • 6334:gRPC 端口。使用二进制协议(protobuf),在大批量 upsert 或批量搜索等吞吐量较大的操作中比 REST API 更快。SetFN 在 知识存储 中支持 gRPC 连接,建议搜索和向量存储优先使用 gRPC。

连接到 SetFN

在知识存储的 向量数据库设置 中输入以下项目,然后点击 保存 按钮。

选择 Qdrant 作为驱动程序时的向量数据库设置页面

项目值
驱动程序Qdrant
集合要使用的集合名称。请为每个实例分别指定不同的名称。
REST 端点Qdrant 服务器的 REST API 地址(例如:http://localhost:6333)
gRPC 端点(推荐)与 REST 相同的 Qdrant 实例的 gRPC 地址(例如:http://localhost:6334)。搜索和向量存储优先使用 gRPC。留空时,如果 REST 地址使用 6333 端口,则自动使用 6334;无法连接时切换为 REST。
API 密钥仅在 Qdrant 启用了认证时输入。留空时以无认证方式连接;将已保存的值清空后保存即删除。

保存后,如果 向量数据库概览 中的连接状态变为 已连接,并且向量存储显示为 Qdrant,则表示连接正常。

相关文档