Qdrant在Linux系统下的编译与安装指南

前言

Qdrant是一款高性能的向量搜索引擎，采用Rust语言编写。本文将详细介绍如何在Linux系统下完成Qdrant的编译和安装过程，特别针对不使用Docker容器的场景。

环境准备

在开始安装Qdrant之前，需要确保系统满足以下依赖条件：

1. GLIBC 2.39 - GNU C库
2. GLIBCXX 3.4.30 - 对应gcc-12.4.0版本
3. CXXABI 1.3.13 - C++应用二进制接口

依赖检查方法

可以通过以下命令检查当前系统是否满足要求：

ldd --version | grep -i glibc
gcc --version

GLIBC安装与配置

下载与解压

从官方渠道获取glibc-2.39源码包并解压：

tar -xzvf glibc-2.39.tar.gz -C /opt/glibc/

依赖检查

在编译前需要确认以下工具已安装且版本符合要求：

• make 4.0+
• gdb 7.8+
• python 3.4+
• binutils 2.26+
• texinfo 4.7+
• bison 2.7+
• sed 3.02+
• gettext 0.10.36+

编译安装

1. 创建独立的编译目录：

mkdir /opt/glibc/glibc-2.39-build

2. 配置编译参数：

cd /opt/glibc/glibc-2.39-build
../glibc-2.39-src/configure --prefix=/opt/ld-cpl \
    --disable-profile \
    --enable-add-ons \
    --with-headers=/usr/include \
    --with-binutils=/usr/bin \
    --disable-sanity-checks \
    --disable-werror

3. 执行编译：

make -j$(nproc)
make install

GCC安装与配置

下载与解压

获取gcc-12.4.0源码包并解压：

tar -xzvf gcc-12.4.0.tar.gz -C /opt/glibc/

依赖检查

确保以下库已安装：

• GMP 4.3.2+
• MPFR 3.1.0+
• MPC 1.0.1+

编译安装

1. 创建编译目录：

mkdir /opt/glibc/gcc-12.4.0-build

2. 配置编译参数：

cd /opt/glibc/gcc-12.4.0-build
../gcc-12.4.0-src/configure --prefix=/opt/ld-cpl --disable-multilib

3. 执行编译：

make -j$(nproc)
make install

Qdrant安装步骤

获取二进制文件

下载Qdrant的Linux版本二进制包并解压：

tar -xzvf qdrant-x86_64-unknown-linux-gnu.tar.gz
chmod +x qdrant

配置动态链接库

使用patchelf工具配置正确的库路径：

patchelf --set-interpreter /opt/ld-cpl/lib/ld-linux-x86-64.so.2 ./qdrant
patchelf --set-rpath /opt/ld-cpl/lib64 ./qdrant

创建配置文件

新建配置文件config.yaml，包含以下基本配置：

log_level: INFO
storage:
  storage_path: ./storage
  snapshots_path: ./snapshots
service:
  host: 0.0.0.0
  http_port: 6333
  grpc_port: 6334
  enable_cors: true

启动Qdrant服务

使用nohup后台运行：

nohup ./qdrant --config-path=./config.yaml > qdrant.log 2>&1 &

验证安装

通过以下方式验证服务是否正常运行：

curl http://localhost:6333/readyz

预期应返回"OK"响应。

常见问题解决

1. GLIBC版本冲突：确保已正确设置动态链接器路径
2. 内存不足：编译时减少并行任务数(-j参数)
3. 端口冲突：检查6333和6334端口是否被占用

性能优化建议

1. 根据服务器CPU核心数调整make的-j参数
2. 生产环境建议配置TLS加密
3. 大数据量场景下适当调整存储路径配置

结语

通过本文的详细步骤，您应该已经成功在Linux系统上完成了Qdrant的编译和安装。Qdrant作为一款高性能向量搜索引擎，能够为您的应用提供强大的相似性搜索能力。如需进一步了解Qdrant的高级功能，建议查阅官方文档。