1、启动docker
本地windows 桌面打开docker客户端
2、开源Qdrant
Qdrant：轻量单机王者、极简好上手、资源占用低、API 清爽、本地开发首选，主打百万级以内数据、快速落地、少运维
存数据
用户文档 → 文本切片 → 向量化 → 存入 Qdrant
用户提问
用户问题 → **向量化** → 用向量去 Qdrant 搜索 → 返回最相似的文本
首次需要下载镜像文件
docker pull qdrant/qdrant
安装成功后，启动Qdrant知识库
6333是http端口，6334是grpc端口
docker run -d --name qdrant -p 6333:6333 -p 6334:6334 -v ${PWD}/qdrant_storage:/qdrant/storage --restart unless-stopped qdrant/qdrant
浏览器访问
http://localhost:6333/
查看图形化界面
http://localhost:6333/dashboard
面板左侧菜单介绍
左侧菜单 | 中文 | 用途 |
Welcome 欢迎 | 首页 | 你现在这个主页，快速入门引导 |
Console 控制台 | API 调试终端 | 可以直接网页里发 HTTP 请求、写 API 语句操作库，不用 Postman |
Collections 收藏（集合） | 向量集合管理 | 最常用！在这里网页可视化创建集合、查看向量数据、删除、修改集合配置 |
Tutorial 教程 | 官方教程 | 官方自带上手案例 |
Datasets 数据集 | 示例数据集 | 一键导入官方测试向量数据，用来练手检索 |
Access Tokens 访问令牌 | API 密钥管理 | 后续你加访问鉴权、设置 API Key 就在这里配置 |
排查Qdrant问题
# 查看正在运行的qdrant容器
docker ps
# 查看容器运行日志（排查问题用）
docker logs -f qdrant
# 停止数据库
docker stop qdrant
# 再次启动数据库（数据全部保留）
docker start qdrant
Qdrant 本地启动
删除旧容器
docker stop qdrant
docker rm qdrant
带秘钥启动
docker run -d `
--name qdrant `
-p 6333:6333 `
-p 6334:6334 `
-v D:/qdrant_storage:/qdrant/storage `
-e QDRANT__SERVICE__API_KEY=my_secure_key_123 `
qdrant/qdrant
// -v 指的源数据 //这里 my_secure_key_123 就是你的秘钥
查看秘钥命令
方法1：
docker inspect qdrant | Select-String QDRANT__SERVICE__API_KEY方法
方法2：
docker exec -it qdrant bash
cat /qdrant/config/config.yaml | grep api_key
忘记秘钥怎么办？
只能重新启动容器并指定新秘钥：
docker stop qdrant
docker rm qdrant
# 换个新密钥
docker run -d `
--name qdrant `
-p 6333:6333 `
-p 6334:6334 `
-v D:/docker-compost/qdrant_storage:/qdrant/storage `
-e QDRANT__SERVICE__API_KEY=txjy2026tts `
qdrant/qdrant