Milvus 是一个高性能的开源向量数据库,广泛应用于大规模向量检索。安装 Milvus 的方法有多种,包括 Docker 安装 、源码安装 和 二进制文件安装。下面是几种常见的安装方法。
方法一:使用 Docker 安装 Milvus
这是最常用和推荐的方法,适合快速部署和使用。
前提条件
-
安装了 Docker 和 Docker Compose。可以通过以下命令检查是否安装了 Docker 和 Docker Compose:
bashdocker --version docker-compose --version
安装步骤
-
拉取 Milvus 镜像
进入命令行终端,执行以下命令来拉取 Milvus 最新版本的 Docker 镜像:
bashdocker pull milvusdb/milvus:v2.3.0
-
下载并启动 Docker Compose 配置
Milvus 提供了一个官方的 Docker Compose 配置文件,用于在容器中启动所有相关组件(如 Milvus 服务、Zookeeper、etcd 等)。
下载官方的
docker-compose.yml
文件:bashwget https://raw.githubusercontent.com/milvus-io/milvus/v2.3.0/docker/docker-compose.yml
-
启动 Milvus
使用 Docker Compose 启动 Milvus 和相关的服务:
bashdocker-compose -f docker-compose.yml up -d
这个命令会启动 Milvus 和它的依赖服务,如 Zookeeper 和 etcd。
-
检查 Milvus 状态
确认 Milvus 服务已经启动,并运行正常:
bashdocker-compose ps
如果一切正常,Milvus 服务将在
8080
端口提供 HTTP API,默认使用19530
端口进行向量检索。 -
访问 Milvus Web 界面
通过浏览器访问 Milvus Web 界面(如果配置了),默认地址为:
bashhttp://localhost:3000
停止 Milvus
如果你想停止正在运行的 Milvus,可以执行以下命令:
bash
docker-compose down
方法二:从源代码安装 Milvus
如果你需要自定义 Milvus 或参与开发,你可以选择从源代码编译并安装 Milvus。
前提条件
-
安装了 Go 环境:Milvus 是用 Go 语言编写的,所以你需要安装 Go 环境。
安装 Go:
bashwget https://golang.org/dl/go1.18.linux-amd64.tar.gz sudo tar -C /usr/local -xvzf go1.18.linux-amd64.tar.gz
设置 Go 环境变量:
bashexport PATH=$PATH:/usr/local/go/bin
-
安装 CMake:Milvus 使用 CMake 构建,因此需要安装它。
bashsudo apt install cmake
-
安装 GCC 和 G++:
bashsudo apt-get install build-essential
-
安装 protobuf:
bashsudo apt-get install libprotobuf-dev protobuf-compiler
安装步骤
-
克隆 Milvus 仓库
bashgit clone https://github.com/milvus-io/milvus.git cd milvus
-
构建 Milvus
使用 CMake 构建 Milvus:
bashmkdir build cd build cmake .. make -j
-
启动 Milvus
编译完成后,可以通过以下命令启动 Milvus:
bash./milvus-server
方法三:使用二进制文件安装 Milvus
如果不想从源代码编译,您可以直接使用 Milvus 的预构建二进制文件。
安装步骤
-
下载 Milvus 二进制文件
访问 Milvus Releases 页面,选择你需要的版本并下载适用于你操作系统的二进制文件。
-
解压文件
下载完成后,解压文件:
bashtar -zxvf milvus-<version>.tar.gz cd milvus-<version>
-
启动 Milvus
通过以下命令启动 Milvus:
bash./milvus-server
检查 Milvus 是否运行正常
无论是 Docker 安装、源码安装还是二进制文件安装,你都可以通过以下几种方式确认 Milvus 是否启动成功:
-
检查 Milvus 服务 :访问 Milvus API 默认端口
19530
进行连接:bashtelnet localhost 19530
-
访问 Web 界面:如果启用了 Milvus 的 Web 界面,可以通过浏览器访问:
bashhttp://localhost:3000
-
查看日志:查看 Milvus 的日志输出,检查是否有错误信息。
-
Docker 容器日志:
bashdocker logs milvus
-
常见问题
-
问题:Milvus 服务无法启动,出现错误。
- 解决 :检查
docker-compose
输出或查看日志,确认相关服务(如 Zookeeper、etcd)是否启动成功。
- 解决 :检查
-
问题:无法连接到 Milvus 的 API 或端口。
- 解决 :确保防火墙和网络配置允许访问
19530
和其他端口。
- 解决 :确保防火墙和网络配置允许访问
-
问题:如何配置 Milvus 的存储路径和其他参数?
- 解决 :你可以在
docker-compose.yml
文件或源代码中修改 Milvus 配置文件,设置存储路径和其他参数。
- 解决 :你可以在