【Milvus安装】Windows安装Milvus向量数据库保姆级教程｜一步一图从零搭建
一、Milvus 是什么Milvus米尔沃斯是目前最火的开源向量数据库专门用来存储、索引和搜索海量向量数据是 RAG 检索增强生成、推荐系统、图像检索等 AI 应用的标配。核心能力 亿级向量毫秒级检索 支持 IVF、HNSW 等多种索引 完美对接 LangChain、LlamaIndex️ 单机 / 集群多种部署方式⚠️划重点Milvus没有原生 Windows 版本官方推荐通过Docker Desktop WSL2运行。这是标准方案性能和 Linux 几乎无差别放心用。二、第一步检查虚拟化是否开启安装 Docker 之前先确认你的 CPU 虚拟化已经打开。操作步骤按下Ctrl Shift Esc打开任务管理器点击「性能」选项卡 → 选择「CPU」看右下角有没有「虚拟化已启用」状态怎么办✅ 已启用直接往下走❌ 未启用重启电脑进 BIOS打开 Intel VT-x / AMD-V三、第二步安装 Docker Desktop3.1 下载安装官网下载https://www.docker.com/get-started/双击安装包一路下一步安装完必须重启电脑WSL2 内核更新需要3.2 确认 Docker 运行正常重启后 Docker Desktop 会自动启动看到下面这个界面左下角鲸鱼图标是绿色的就说明运行正常3.3 验证 WSL2打开 PowerShell 执行wsl --list --verbose看到docker-desktop状态是Running、版本是2就 OK 了。四、第三步安装 Milvus一键脚本法推荐新手用官方一键脚本最简单一条命令搞定。4.1 创建工作目录打开 PowerShell执行# 切换到D盘推荐别放C盘 D: # 创建milvus文件夹 mkdir milvus cd milvus4.2 下载安装脚本Invoke-WebRequest https://raw.githubusercontent.com/milvus-io/milvus/refs/heads/master/scripts/standalone_embed.bat -OutFile standalone.bat下载失败怎么办GitHub 网络不好的话换这条命令certutil -urlcache -split -f https://raw.githubusercontent.com/milvus-io/milvus/refs/heads/master/scripts/standalone_embed.bat standalone.bat4.3 启动 Milvus.\standalone.bat start首次启动会自动拉取镜像大概 3~10 分钟耐心等。看到下面的提示就说明成功了五、第四步验证安装结果5.1 查看容器状态docker ps正常会看到3 个容器都在运行三个容器分别是容器名作用milvus-standaloneMilvus 核心服务milvus-etcd元数据存储milvus-minio对象存储存向量数据文件5.2 端口说明端口用途19530主端口gRPCPython SDK 用这个9091HTTP API 端口六、第五步安装 Attu 可视化工具光用命令行不方便Attu 是官方可视化管理工具图形化查看集合、数据、索引。6.1 下载 Attu 桌面版打开下载页https://github.com/zilliztech/attu/releases找最新版下载 Windows 安装包attu-windows-x64.exe双击安装下一步下一步6.2 连接 Milvus打开 Attu输入连接信息Milvus 地址localhost:19530用户名留空密码留空点「连接」就进去了6.3 Attu 主界面连接成功后你可以看到所有集合、向量数量、状态等信息⚠️版本匹配提醒Milvus 2.5.x 对应 Attu 2.5.x版本不匹配会连接失败。七、第六步Python 连接测试用代码验证一下能不能正常操作。7.1 安装 SDKpip install pymilvus7.2 测试代码from pymilvus import MilvusClient 连接本地 Milvus client MilvusClient(urihttp://localhost:19530) print(✅ Milvus 连接成功) 创建测试集合 client.create_collection( collection_namehello_milvus, dimension768 ) print(✅ 测试集合创建成功) 查看所有集合 print(当前集合, client.list_collections())运行效果看到这个输出恭喜你Milvus 环境完全搞定了八、第七步对接 LangChain进阶和上一篇的文档切分无缝对接几行代码搞定向量存储from langchain_milvus import Milvus from langchain_community.embeddings import HuggingFaceEmbeddings 初始化 embedding 模型 embeddings HuggingFaceEmbeddings(model_nameall-MiniLM-L6-v2) 文档块存入 Milvus vector_store Milvus.from_documents( documentschunk_docs, # 上一篇切好的文本块 embeddingembeddings, connection_args{host: localhost, port: 19530}, collection_nameknowledge_base, ) 相似度检索 results vector_store.similarity_search(保修政策是什么, k3)九、常用命令速查表# 启动 Milvus .\standalone.bat start 停止 Milvus .\standalone.bat stop 查看状态 .\standalone.bat status 查看日志 docker logs milvus-standalone 完全卸载删所有数据 .\standalone.bat delete十、常见踩坑解决方案❌ 坑 1Docker Engine 启动失败解决确认虚拟化已开任务管理器看执行wsl --update更新内核重启 Docker Desktop❌ 坑 2镜像拉取慢 / 失败解决配置国内镜像源Docker Desktop → Settings → Docker Engine加入{ registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://hub-mirror.c.163.com ] }Apply Restart 重启。❌ 坑 3C 盘空间被占满原因Docker 默认数据存在 C 盘解决迁移到 D 盘Docker Desktop → Settings → Resources → Disk image location → 改到 D 盘❌ 坑 4Python 连不上排查顺序docker ps确认容器在跑telnet localhost 19530确认端口通检查防火墙临时关了试试URI 写全http://localhost:19530十一、全文总结Milvus 没有 Windows 原生版通过 Docker Desktop WSL2 运行是官方标准方案安装三步曲装 Docker → 跑一键脚本 → Attu 可视化管理三个核心容器milvus-standalone主服务、etcd元数据、minio对象存储默认端口 19530Python SDK 和 LangChain 都用这个Attu 必备图形化管理调试、查数据都靠它觉得有用的话点赞 收藏 关注持续更新 RAG 从零到企业级落地全套教程
)
