📌 文章摘要

想要在本地搭建 RAG 知识库，Milvus 向量数据库是热门选择。很多 Windows 用户部署第一步就踩坑：Docker 默认安装到 C 盘、镜像拉取缓慢、命令执行报错。本文完整讲解 Docker Desktop 自定义盘符安装、国内镜像源配置、WSL 环境更新，通过一键脚本快速启动独立版 Milvus，适合大模型开发、LangChain 本地调试使用。

一、安装 Docker Desktop

1. 安装包下载

官方最新版下载地址： https://www.docker.com/products/docker-desktop/

低版本 4.X 备用下载地址： https://pan.baidu.com/s/1fmUtPvJhL1lULdvin9HUpw?pwd=vyyn#list/path=%2FWindows%E7%9A%84Docker%20Desktop4.X%E7%B3%BB%E5%88%97%2FDocker%20%E6%A1%8C%E9%9D%A2%E7%89%88%204.12.0

Docker 汉化参考：

参考文献：https://blog.csdn.net/Little_Carter/article/details/155263711

⚠️ 重要提醒：执行自定义安装命令不要使用 PowerShell，务必使用 CMD 终端，否则命令会报错！

2. 自定义路径安装（避免塞满 C 盘）

直接双击安装程序，Docker 会默认安装在 C 盘。镜像、容器长期占用空间可达几十 GB，强烈建议自定义安装位置。 将安装程序放到桌面，打开 CMD，执行静默安装命令：

cmd

start /w "" "C:\Users\Administrator\Desktop\Docker Desktop Installer.exe" install --installation-dir=D:\software\docker_desktop --wsl-default-data-root=D:\docker\wsl_data

假如直接双击的话，是安装到 C 盘的，这样的话非常占磁盘的空间。

安装完成之后，查看版本：

docker --version

登录是可以跳过的：

首次启动会看到 Docker Desktop 的设置向导，来到登录账号这里，我们可以暂时跳过登录，点击"Skip"跳过即可。然后就会进入到 Docker Desktop 里面了。

设置磁盘路径：

修改磁盘镜像存储数据

我建议大家一定要修改，因为这个目录存储了所有 Docker 数据：包含所有镜像、容器、数据卷。一般来说，至少几十个G啊，安装到非C盘，可以节省C盘空间，提高性能，便于备份和管理。并且还建议大家一定要修改下面这个目录，这样所有的数据都不会存储在C盘了。

但是由于系统的问题，如果修改报错，C盘空间也比较大，不修改也能用，这里只是建议。

配置docker国内镜像源

我安装的时候，经常会遇到卡顿，总是拉取不了镜像，其实原因就在于没有配置好国内镜像源。我们需要打开Docker界面，来到右上角的【设置⚙️】，点击【Docker Engine】，复制我提供的国内源代码，需要整体复制粘贴的喔！最后点击【Apply & restart】确认

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "features": {
    "buildkit": true
  },
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://registry.docker-cn.com",
    "http://hub-mirror.c.163.com",
    "https://mirror.ccs.tencentyun.com",
    "https://docker.m.daocloud.io",
    "https://docker.imgdb.de",
    "https://docker-0.unsee.tech",
    "https://docker.hlmirror.com",
    "https://docker.1ms.run",
    "https://func.ink",
    "https://lispy.org",
    "https://docker.xiaogenban1993.com"
  ]
}

更新 wsl：

wsl --update

wsl下载不下来或者下载很慢的可以下载上面发的，双击运行，等下载完在cmd里运行wsl --version，有东西就是下载成功了

该资源我已放在文章中：

资源名：wsl.2.9.4.0.x64.msi

二、Docker 部署 Milvus（米尔沃斯）向量数据库

前置条件：以管理员身份运行 Docker Desktop，保证程序正常启动。

1. 下载启动脚本

打开 PowerShell，执行命令下载 standalone.bat 启动脚本：

powershell

Invoke-WebRequest https://raw.githubusercontent.com/milvus-io/milvus/refs/heads/master/scripts/standalone_embed.bat -OutFile standalone.bat

2. 启动 Milvus 服务

终端切换到脚本所在文件夹，执行启动命令：

powershell

.\standalone.bat start

3. 服务启动信息说明

运行安装脚本后

• 名为Milvus-standalone的 docker 容器已在19530 端口启动。
• 嵌入式 etcd 与 Milvus 安装在同一个容器中，服务端口为2379。其配置文件被映射到当前文件夹中的embedEtcd.yaml。
• Milvus 数据卷映射到当前文件夹中的volumes/milvus。

可以使用以下命令管理 Milvus 容器和存储的数据。

# Stop Milvus
C:\>standalone.bat stop
Stop successfully.

# Delete Milvus container
C:\>standalone.bat delete
Delete Milvus container successfully. # Container has been removed.
Delete successfully. # Data has been removed.

三、常见问题汇总

1. CMD 安装命令报错：确认使用 CMD 终端，不要使用 PowerShell 运行安装指令
2. 镜像拉取卡住失败：检查镜像配置完整粘贴，重启 Docker Desktop
3. 无法连接 Milvus：确认 Docker 正常运行，19530 端口没有被其他程序占用
4. C 盘空间持续减少：确认安装阶段指定非 C 盘路径，检查 WSL 数据目录位置