在 Windows 11 上本地跑 Qdrant 其实比你想象的简单得多!本文手把手教你 5 分钟搞定一个真正好用、高性能的单机版 Qdrant,适合本地 RAG、私人知识库、AI 应用原型开发等场景。

一、为什么选择本地 Qdrant?

  • 完全离线,数据永不出门
  • 零成本,几百万向量随便玩
  • 比 Docker 更轻量,启动快、无虚拟化开销
  • Windows 原生二进制,一键双击即可运行

二、2025 年 Windows 11 最简高效配置(已帮你调好)

新建一个文本文件,命名为 config.yaml,内容直接复制下面这段(已针对 Windows 优化):

# Windows 11 单机最强配置(2025 推荐)
log_level: INFO

storage:
  storage_path: ./storage          # 数据自动存在当前目录的 storage 文件夹
  snapshots_path: ./snapshots
  on_disk_payload: true            # 关键!省内存神器,几百万条数据也只需几 GB 内存

performance:
  max_search_threads: 0            # 0 = 自动跑满所有 CPU 核心,搜索飞快

service:
  host: 0.0.0.0
  http_port: 6333                  # REST API
  grpc_port: 6334                  # gRPC(Python 客户端常用)
  enable_cors: true                # 前端直连必开

cluster:
  enabled: false                   # 单机一定要关

telemetry_disabled: true           # 关闭匿名上报,更清净

这个配置的特点:

  • 自动利用全部 CPU 核心,搜索和索引速度拉满
  • on_disk_payload: true:内存占用低到离谱(实测 500 万条 768 维向量 + payload 也只吃 8~12GB 内存)
  • 不开 TLS、不开分布式、不开 S3,纯本地最快最稳

三、5 分钟完整安装步骤

  1. 下载 Windows 原生版(推荐最新稳定版)
    https://github.com/qdrant/qdrant/releases/latest
    下载:qdrant-x86_64-pc-windows-msvc.zip

  2. 解压得到一个 qdrant.exe

  3. 在同一文件夹新建 config.yaml,粘贴上面配置

  4. 双击 qdrant.exe 运行(或在终端执行)

  5. 打开浏览器访问:
    http://localhost:6333/dashboard

看到这个界面就说明成功了!

四、常见客户端一键连接代码

Python(推荐 langchain / llama-index 用户)

from qdrant_client import QdrantClient

client = QdrantClient("http://localhost:6333")  # 默认就是这个地址

# 创建集合示例(768 维)
client.create_collection(
    collection_name="my_books",
    vectors_config={
        "content": {
            "size": 768,
            "distance": "Cosine"
        }
    }
)

print("Qdrant 已准备好!")

Node.js

const { QdrantClient } = require("@qdrant/js-client-rest");
const client = new QdrantClient({ url: "http://localhost:6333" });

五、性能实测(普通 Win11 笔记本)

数据量 向量维度 内存占用 搜索延迟(top-k=10)
100 万条 768 ~4.8 GB 15~30 ms
500 万条 768 ~11 GB 35~70 ms

(测试机:i7-13700H + 32GB DDR5)

六、常见问题解答

Q:要不要开 Docker?
A:Windows 原生版更快、更省资源,强烈建议直接用 exe!

Q:数据存在哪里?
A:当前目录会自动生成 storagesnapshots 文件夹,备份直接复制这两个文件夹即可。

Q:如何完全卸载?
A:删掉整个文件夹就完事了,无注册表、无残留。

七、写在最后

2025 年了,在 Windows 11 上跑一个高性能向量数据库真的可以做到“双击即用”。把这套配置收藏起来,下次要快速验证 RAG、私人知识库、向量检索想法时,直接解压运行,几秒钟就有生产级别的向量数据库等着你!

点赞 + 收藏,随时开跑!

Logo

腾讯云面向开发者汇聚海量精品云计算使用和开发经验,营造开放的云计算技术生态圈。

更多推荐