玩转 Milvus（二）：在 Ubuntu 22.04（WSL2）上安装 Milvus

玩转 Milvus（二）：在 Ubuntu 22.04（WSL2）上安装 Milvus

引言：让 Milvus 在你的笔记本上“起飞”

在《玩转 Milvus（一）》中，我们揭开了向量数据库的神秘面纱，认识了 Milvus 作为 AI 时代的“超级引擎”，如何驱动智能搜索、推荐系统和多模态应用。现在，是时候让 Milvus 在你的电脑上“落地生根”了！本篇博客将带你在 Ubuntu 22.04（WSL2） 环境下安装 Milvus，聚焦两种单机模式：Milvus Lite 和 Milvus Standalone。无论你是初学者想快速上手，还是进阶开发者准备小规模生产，这篇教程都能帮你轻松搞定。

Milvus 支持三种部署模式：Milvus Lite（轻量级 Python 库）、Milvus Standalone（单机部署）和 Milvus Distributed（分布式集群）。考虑到我们专栏的目标（单机环境，2025年7月14日会话）和 Ubuntu 22.04/WSL2 的开发环境，本篇只讲 Milvus Lite 和 Milvus Standalone（通过 Docker 和 Docker Compose 两种方式）。分布式部署后续有机会再探讨。

通过详细步骤、验证案例和常见问题解答，你将学会在几分钟内跑通 Milvus，甚至实现一个简单的语义搜索。准备好你的 Ubuntu 终端，让我们开始这场“安装冒险”！

环境准备：为 Milvus 铺好跑道

在安装 Milvus 之前，需要确保你的 Ubuntu 22.04（WSL2）环境已准备就绪。以下是详细要求和配置步骤。

系统环境

• 操作系统：Ubuntu 22.04，运行在 WSL2 上（Windows 10/11）。
• 硬件要求：
  • CPU：支持 AVX512 或 SIMD 指令（参考2025年5月6日会话），普通笔记本即可。
  • 内存：建议 8GB+（Milvus Lite）或 16GB+（Standalone）。
  • 磁盘：至少 10GB 可用空间（MinIO 存储向量和元数据）。
• WSL2 注意事项：
  • 确保 WSL2 已正确安装：运行 wsl --version，应显示 WSL 2。
  • 推荐使用 Docker Desktop 与 WSL2 集成，简化 Docker 管理。
  • 在 Windows 的 Docker Desktop 设置中，启用 WSL2 后端（Settings > Resources > WSL Integration），选择 Ubuntu 22.04 分发。

必要软件

1. Docker（用于 Milvus Standalone）：

   • 安装命令：

     sudo apt update
     sudo apt install -y docker.io
     sudo systemctl start docker
     sudo systemctl enable docker
     

   • 验证：docker --version（应显示 Docker 20.x 或更高）。

   • WSL2 特殊配置：确保 Docker Desktop 运行，WSL2 可通过 sudo service docker start 启动 Docker（若未用 Docker Desktop）。

2. Docker Compose（用于 Standalone 的 Docker Compose 方式）：

   • 安装命令：

     sudo apt install -y docker-compose
     

   • 验证：docker-compose --version（应显示 Docker Compose 1.29.x 或更高）。

3. Python 3.7+（用于 Milvus Lite 和验证）：

   • 安装命令：

     sudo apt install -y python3 python3-pip
     

   • 验证：python3 --version（应显示 3.7 或更高）。

为什么选择 WSL2 而非 Docker Desktop 直接安装？

• WSL2 优势：轻量、灵活，Ubuntu 环境更接近生产服务器，适合开发者调试。Docker Desktop 虽方便，但在 Windows 上直接运行可能遇到权限或网络问题（如 localhost 访问失败）。
• 注意：本篇使用 WSL2 的 Ubuntu 22.04 运行 Docker，避免 Windows 环境的复杂配置。若你更喜欢 Windows 原生 Docker Desktop，可参考 Milvus 文档。

Milvus 安装方式综述：选择你的“起飞方式”

Milvus 提供三种部署模式，适合不同场景：

• Milvus Lite：像笔记本上的“迷你数据库”，通过 Python 库运行，无需额外服务器，适合快速学习和原型开发。
• Milvus Standalone：单机“全能选手”，支持中等规模数据，适合开发、测试或小规模生产。
• Milvus Distributed：分布式“超级舰队”，适合亿级向量和企业级场景。

对于 Milvus Standalone，我们将介绍两种安装方式：

• Docker（Linux）：通过单个容器快速启动，简单直接。
• Docker Compose（Linux）：通过配置文件管理 Milvus 及其依赖（etcd、MinIO），适合自定义配置。

本篇聚焦 Milvus Lite 和 Milvus Standalone（Docker 和 Docker Compose），基于 Ubuntu 22.04（WSL2）。

安装方式对比：