Milvus 安装和启动指南

Milvus 是一个高性能的开源向量数据库，广泛应用于大规模向量检索。安装 Milvus 的方法有多种，包括 Docker 安装、源码安装 和 二进制文件安装。下面是几种常见的安装方法。

---

方法一：使用 Docker 安装 Milvus

这是最常用和推荐的方法，适合快速部署和使用。

前提条件

1. 安装了 Docker 和 Docker Compose。可以通过以下命令检查是否安装了 Docker 和 Docker Compose：

   docker --version
   docker-compose --version
   

安装步骤

1. 拉取 Milvus 镜像
   进入命令行终端，执行以下命令来拉取 Milvus 最新版本的 Docker 镜像：

   docker pull milvusdb/milvus:v2.3.0
   

2. 下载并启动 Docker Compose 配置
   Milvus 提供了一个官方的 Docker Compose 配置文件，用于在容器中启动所有相关组件（如 Milvus 服务、Zookeeper、etcd 等）。
   下载官方的 docker-compose.yml 文件：

   wget https://raw.githubusercontent.com/milvus-io/milvus/v2.3.0/docker/docker-compose.yml
   

3. 启动 Milvus
   使用 Docker Compose 启动 Milvus 和相关的服务：

   docker-compose -f docker-compose.yml up -d
   

   这个命令会启动 Milvus 和它的依赖服务，如 Zookeeper 和 etcd。

4. 检查 Milvus 状态
   确认 Milvus 服务已经启动，并运行正常：

   docker-compose ps
   

   如果一切正常，Milvus 服务将在 8080 端口提供 HTTP API，默认使用 19530 端口进行向量检索。

5. 访问 Milvus Web 界面
   通过浏览器访问 Milvus Web 界面（如果配置了），默认地址为：

   http://localhost:3000
   

停止 Milvus

如果你想停止正在运行的 Milvus，可以执行以下命令：

docker-compose down

---

方法二：从源代码安装 Milvus

如果你需要自定义 Milvus 或参与开发，你可以选择从源代码编译并安装 Milvus。

前提条件

1. 安装了 Go 环境：Milvus 是用 Go 语言编写的，所以你需要安装 Go 环境。
   安装 Go：

   wget https://golang.org/dl/go1.18.linux-amd64.tar.gz
   sudo tar -C /usr/local -xvzf go1.18.linux-amd64.tar.gz
   

   设置 Go 环境变量：

   export PATH=$PATH:/usr/local/go/bin
   

2. 安装 CMake：Milvus 使用 CMake 构建，因此需要安装它。

   sudo apt install cmake
   

3. 安装 GCC 和 G++：

   sudo apt-get install build-essential
   

4. 安装 protobuf：

   sudo apt-get install libprotobuf-dev protobuf-compiler
   

安装步骤

1. 克隆 Milvus 仓库

   git clone https://github.com/milvus-io/milvus.git
   cd milvus
   

2. 构建 Milvus
   使用 CMake 构建 Milvus：

   mkdir build
   cd build
   cmake ..
   make -j
   

3. 启动 Milvus
   编译完成后，可以通过以下命令启动 Milvus：

   ./milvus-server
   

---

方法三：使用二进制文件安装 Milvus

如果不想从源代码编译，您可以直接使用 Milvus 的预构建二进制文件。

安装步骤

1. 下载 Milvus 二进制文件
   访问 Milvus Releases 页面，选择你需要的版本并下载适用于你操作系统的二进制文件。

2. 解压文件
   下载完成后，解压文件：

   tar -zxvf milvus-<version>.tar.gz
   cd milvus-<version>
   

3. 启动 Milvus
   通过以下命令启动 Milvus：

   ./milvus-server
   

---

检查 Milvus 是否运行正常

无论是 Docker 安装、源码安装还是二进制文件安装，你都可以通过以下几种方式确认 Milvus 是否启动成功：

1. 检查 Milvus 服务：访问 Milvus API 默认端口 19530 进行连接：

   telnet localhost 19530
   

2. 访问 Web 界面：如果启用了 Milvus 的 Web 界面，可以通过浏览器访问：

   http://localhost:3000
   

3. 查看日志：查看 Milvus 的日志输出，检查是否有错误信息。

   • Docker 容器日志：

     docker logs milvus
     

---

常见问题

• 问题：Milvus 服务无法启动，出现错误。

  • 解决：检查 docker-compose 输出或查看日志，确认相关服务（如 Zookeeper、etcd）是否启动成功。

• 问题：无法连接到 Milvus 的 API 或端口。

  • 解决：确保防火墙和网络配置允许访问 19530 和其他端口。

• 问题：如何配置 Milvus 的存储路径和其他参数？

  • 解决：你可以在 docker-compose.yml 文件或源代码中修改 Milvus 配置文件，设置存储路径和其他参数。