Windows 10/WSL2用户福音：手把手教你解压运行Qdrant 1.13.4（免Docker，开箱即用）
Windows 10/WSL2用户福音：手把手教你解压运行Qdrant 1.13.4（免Docker，开箱即用）
如果你是一位在Windows环境下工作的AI开发者，想要快速搭建一个Qdrant向量数据库实例用于原型开发或学习，但又不想启动沉重的Docker Desktop，那么这篇文章就是为你量身定制的。我们将详细介绍两种在Windows平台上运行Qdrant的方案：通过WSL2的Ubuntu环境直接运行Linux版本，以及在Windows宿主机上直接运行预编译的Windows版本。无论你选择哪种方式，都能轻松实现免Docker的Qdrant部署。
1. 方案选择：WSL2 vs Windows原生
在开始之前，我们需要明确两种方案的适用场景和优缺点：
WSL2方案：
- 优点：更接近原生Linux环境，兼容性好，适合长期开发
- 缺点：需要安装WSL2和Ubuntu发行版，占用更多磁盘空间
Windows原生方案：
- 优点：无需额外环境，解压即用，适合快速测试
- 缺点：功能可能不如Linux版本完整
为了帮助你做出选择，我们整理了以下对比表格：
| 特性 | WSL2方案 | Windows原生方案 |
|---|---|---|
| 安装复杂度 | 中等 | 简单 |
| 性能 | 接近原生Linux | 略低于WSL2 |
| 资源占用 | 较高 | 较低 |
| 适合场景 | 长期开发 | 快速测试 |
| 端口映射 | 需要手动配置 | 自动可用 |
提示：如果你已经安装了WSL2，建议优先使用WSL2方案；如果你只是想快速体验Qdrant，Windows原生方案更为便捷。
2. WSL2方案详细步骤
2.1 环境准备
首先，确保你的系统满足以下要求：
- Windows 10版本2004或更高，或Windows 11
- 已启用WSL2功能
- 已安装Ubuntu发行版（建议20.04或22.04）
如果你尚未安装WSL2，可以通过以下步骤快速设置：
- 以管理员身份打开PowerShell
- 运行以下命令启用WSL功能：
wsl --install - 重启计算机
- 从Microsoft Store安装Ubuntu发行版
2.2 安装Qdrant
在WSL2的Ubuntu环境中，我们可以直接使用Qdrant提供的.deb包进行安装：
- 首先，打开Ubuntu终端，更新软件包列表：
sudo apt update - 下载Qdrant 1.13.4的.deb包：
wget https://github.com/qdrant/qdrant/releases/download/v1.13.4/qdrant_1.13.4-1_amd64.deb - 安装下载的.deb包：
sudo dpkg -i qdrant_1.13.4-1_amd64.deb - 解决可能的依赖问题：
sudo apt --fix-broken install
2.3 配置和启动服务
安装完成后，Qdrant会自动注册为systemd服务。我们可以通过以下命令管理它：
- 启动服务：
sudo systemctl start qdrant - 设置开机自启：
sudo systemctl enable qdrant - 检查服务状态：
sudo systemctl status qdrant
2.4 端口映射与访问
默认情况下，Qdrant会在WSL2内部的6333端口提供服务。为了从Windows主机访问，我们需要设置端口转发：
- 在Ubuntu中找出WSL2的IP地址：
ip addr show eth0 | grep inet - 在Windows PowerShell中设置端口转发（假设WSL2 IP为172.28.112.1）：
netsh interface portproxy add v4tov4 listenport=6333 listenaddress=0.0.0.0 connectport=6333 connectaddress=172.28.112.1 - 验证端口转发：
netsh interface portproxy show all
现在，你可以在Windows浏览器中访问http://localhost:6333/dashboard来使用Qdrant的Web界面了。
3. Windows原生方案详细步骤
3.1 下载和解压
对于不想使用WSL2的用户，Qdrant提供了Windows原生版本：
- 访问Qdrant的GitHub发布页面：
https://github.com/qdrant/qdrant/releases/tag/v1.13.4 - 下载
qdrant-x86_64-pc-windows-msvc.zip文件 - 解压zip文件到你喜欢的目录，例如
C:\qdrant
3.2 运行Qdrant
解压后，你可以直接运行Qdrant：
- 打开PowerShell或CMD
- 导航到解压目录：
cd C:\qdrant - 运行Qdrant：
.\qdrant.exe
为了更方便地使用，你可以创建一个批处理文件start_qdrant.bat：
@echo off cd /d %~dp0 start /B .\qdrant.exe这样双击批处理文件即可在后台运行Qdrant。
3.3 验证服务
Qdrant启动后，默认会在http://localhost:6333提供服务。你可以通过以下方式验证：
- 在浏览器中访问
http://localhost:6333/dashboard - 使用curl测试API：
应该返回一个空列表curl http://localhost:6333/collections{"result":{"collections":[]}}
4. 常见问题与优化建议
4.1 性能优化
无论是WSL2还是Windows原生方案，都可以通过以下方式优化Qdrant性能：
- 内存分配：编辑配置文件调整内存限制
- 存储路径：指定更快的存储设备作为数据目录
- 并发设置：根据CPU核心数调整工作线程数量
对于WSL2用户，特别建议：
- 在
%USERPROFILE%\.wslconfig中添加以下内容：[wsl2] memory=8GB processors=4 - 重启WSL2：
wsl --shutdown
4.2 常见问题解决
问题1：WSL2中端口转发不工作
- 解决方案：检查Windows防火墙设置，确保允许WSL2的网络连接
问题2：Windows原生版本启动报错
- 解决方案：确保安装了最新的VC++运行库
问题3：Dashboard无法访问
- 解决方案：检查Qdrant是否正常运行，端口是否被占用
4.3 进阶配置
Qdrant提供了丰富的配置选项，可以通过修改配置文件来定制：
- 找到配置文件位置：
- WSL2：
/etc/qdrant/qdrant.yaml - Windows：解压目录下的
config.yaml
- WSL2：
- 常用配置项：
storage: snapshot_path: "/path/to/snapshots" service: grpc_port: 6334 cluster: enabled: false
5. 快速上手：使用Qdrant REST API
现在你的Qdrant实例已经运行起来了，让我们快速体验一下它的REST API：
- 创建一个名为"test_collection"的集合：
curl -X PUT http://localhost:6333/collections/test_collection \ -H 'Content-Type: application/json' \ -d '{ "vectors": { "size": 4, "distance": "Dot" } }' - 插入一些向量数据：
curl -X POST http://localhost:6333/collections/test_collection/points \ -H 'Content-Type: application/json' \ -d '{ "points": [ { "id": 1, "vector": [0.1, 0.2, 0.3, 0.4], "payload": {"city": "Berlin"} }, { "id": 2, "vector": [0.5, 0.6, 0.7, 0.8], "payload": {"city": "London"} } ] }' - 进行相似性搜索：
curl -X POST http://localhost:6333/collections/test_collection/points/search \ -H 'Content-Type: application/json' \ -d '{ "vector": [0.4, 0.5, 0.6, 0.7], "limit": 1 }'
通过这些简单的API调用，你就可以开始构建基于向量的搜索应用了。