准备 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 |
| 集合 | 要使用的集合名称。请为每个实例分别指定不同的名称。 |
| REST 端点 | Qdrant 服务器的 REST API 地址(例如:http://localhost:6333) |
| gRPC 端点(推荐) | 与 REST 相同的 Qdrant 实例的 gRPC 地址(例如:http://localhost:6334)。搜索和向量存储优先使用 gRPC。留空时,如果 REST 地址使用 6333 端口,则自动使用 6334;无法连接时切换为 REST。 |
| API 密钥 | 仅在 Qdrant 启用了认证时输入。留空时以无认证方式连接;将已保存的值清空后保存即删除。 |
保存后,如果 向量数据库概览 中的连接状态变为 已连接,并且向量存储显示为 Qdrant,则表示连接正常。