Qdrant 向量数据库在 WSL Ubuntu 环境下的完整安装与部署指南

Qdrant 是一款使用 Rust 编写的高性能、轻量级开源向量数据库。它不仅检索速度快、资源占用低，而且开箱即用自带精美的 Web 可视化面板，非常适合作为大模型应用和智能体（Agent）开发的后端向量存储。

本文将手把手带你完成在 Windows WSL (Windows Subsystem for Linux) Ubuntu 环境下部署 Qdrant 向量数据库的完整过程。

第一步：为 WSL 启用 Systemd 服务支持

默认情况下，WSL 中的 Ubuntu 并没有将 systemd 作为初始化系统（PID 1）启动，这会导致 Docker 无法像在标准 Linux 中那样作为系统服务正常运行。

我们在 WSL 内部进行配置： 1. 创建或编辑 WSL 配置文件 /etc/wsl.conf： bash sudo nano /etc/wsl.conf 2. 写入以下内容： ini [boot] systemd=true 3. 保存并退出编辑器。在 Windows 终端（PowerShell 或 CMD）中执行以下命令彻底关闭并重启 WSL： powershell wsl --shutdown 4. 重新打开你的 WSL 终端，此时 systemd 已成功启用。

第二步：安装并启动 Docker 引擎

在 WSL 终端中运行以下命令更新软件源并安装 Docker： bash sudo apt-get update sudo apt-get install -y docker.io

安装完成后，利用 systemd 启动 Docker 服务并设置为开机自启： bash sudo systemctl start docker sudo systemctl enable docker

运行以下命令检查 Docker 服务的运行状态，确保其处于 active (running)： bash systemctl status docker

第三步：拉取镜像并部署 Qdrant 容器

为了确保 Qdrant 数据库中的数据在容器重启后不会丢失，我们需要在宿主机上配置持久化挂载目录。

1. 在 WSL 用户根目录下创建数据存储文件夹： bash mkdir -p /root/qdrant_storage
2. 运行 Qdrant Docker 容器： bash docker run -d \ -p 6333:6333 \ -p 6334:6334 \ -v /root/qdrant_storage:/qdrant/storage \ --name qdrant \ --restart always \ qdrant/qdrant 命令参数解析：
3. -d：后台守护进程方式运行。
4. -p 6333:6333：映射 REST API 端口（也是 Web UI 端口）。
5. -p 6334:6334：映射 gRPC API 端口。
6. -v /root/qdrant_storage:/qdrant/storage：将宿主机的目录挂载到容器内，实现数据持久化。
7. --name qdrant：指定容器名称为 qdrant。
8. --restart always：配置容器开机自启和异常重启策略。

第四步：服务健康检查与接口测试

容器启动后，可以通过运行以下 curl 命令测试其是否正常响应： bash curl -s http://localhost:6333/collections

如果看到如下输出，表示接口已经正常开启，当前集合列表为空： json {"result":{"collections":[]},"status":"ok","time":7.5e-6}

第五步：访问 Qdrant Web Dashboard 可视化面板

Qdrant 自带了极简而功能完备的图形化仪表盘。由于 WSL 和 Windows 共享网络端口，你不需要进行任何端口转发，直接在 Windows 系统的浏览器中输入以下地址即可：

👉 http://localhost:6333/dashboard

在网页控制台中，你可以直观地管理各个 Vector Collections（向量集合），并直接运行交互式的向量检索请求，是开发和调试智能体记忆系统的得力助手。