Docker使用

一、遇到问题

背景：win系统，下载的是doocker desktop。

问题：下是下了很多，但是没管理，以及有些自启动也不知道何意味。

前提：

1、设置里面配置下载镜像是有必要的。

2、记录一个比较顺心的操作：感觉到了命令行的魅力。

二、在 D 盘建好数据文件夹（必须做）

1. 打开「此电脑」→ 进入D 盘
2. 新建文件夹：docker_data
3. 在docker_data里再新建：qdrant_storage最终路径：

D:\docker_data\qdrant_storage

作用：所有向量数据都存在这里，删容器、重装系统都不丢。

三、下载 Qdrant 镜像（2 种方法，任选其一）

方法 1：用命令行（推荐，最稳）

1. 打开PowerShell（Win+X → Windows PowerShell）
2. 输入并运行：

docker pull qdrant/qdrant

• 会自动下载最新版 Qdrant 镜像（约 300MB）
• 出现Status: Downloaded newer image for qdrant/qdrant:latest即完成。

方法 2：用 Docker Desktop 图形界面

1. 打开 Docker Desktop → 左侧点Images
2. 顶部搜索框输入：qdrant/qdrant
3. 点击Pull→ 等待下载完成。

四、启动 Qdrant 容器（关键一步）

方法 A：命令行一键启动（推荐）

在 PowerShell 直接复制运行：

docker run -d -p 6333:6333 -p 6334:6334 -v "D:\docker_data\qdrant_storage:/qdrant/storage" --name qdrant qdrant/qdrant

参数说明：

• -d：后台运行，不占终端
• -p 6333:6333：HTTP 端口映射（外部访问用）
• -p 6334:6334：gRPC 端口（高性能调用）
• -v "D:\...:/qdrant/storage"：数据持久化到 D 盘
• --name qdrant：给容器起固定名字，方便管理

方法 B：Docker Desktop 图形界面启动

1. 左侧Images→ 找到qdrant/qdrant→ 点Run
2. 弹出窗口：
   • Container name：填qdrant
   • Ports：
     • Host port:6333→ Container port:6333
     • Host port:6334→ Container port:6334
   • Volumes：
     • Host path:D:\docker_data\qdrant_storage
     • Container path:/qdrant/storage
3. 点Run→ 启动成功。

五、验证是否成功（必做）

1. 打开浏览器，访问：

http://localhost:6333/dashboard

1. 看到 Qdrant 管理面板 →安装成功。
2. 也可以在 PowerShell 运行：

curl http://localhost:6333/

返回{"status":"ok"}→ 服务正常。

效果：

所以其实是两行代码就完事了~

六、常用管理命令（记这 4 条就行）

• 启动容器：docker start qdrant
• 停止容器：docker stop qdrant
• 查看运行状态：docker ps
• 删除容器（数据还在 D 盘）：docker rm qdrant

七、数据在哪里？

所有向量、集合、配置都在：

D:\docker_data\qdrant_storage

• 容器删了，这个文件夹还在 → 数据不丢
• 重装系统，只要保留这个文件夹 → 恢复即可

八、总结（一句话）

1. D 盘建docker_data/qdrant_storage
2. docker pull qdrant/qdrant下载
3. 用带-v的命令启动 → 数据持久化
4. 访问http://localhost:6333/dashboard验证