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

2. 看到 Qdrant 管理面板 → 安装成功。

3. 也可以在 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 验证