Milvus 安装和启动指南

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


方法一:使用 Docker 安装 Milvus

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

前提条件

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

    bash 复制代码
    docker --version
    docker-compose --version

安装步骤

  1. 拉取 Milvus 镜像

    进入命令行终端,执行以下命令来拉取 Milvus 最新版本的 Docker 镜像:

    bash 复制代码
    docker pull milvusdb/milvus:v2.3.0
  2. 下载并启动 Docker Compose 配置

    Milvus 提供了一个官方的 Docker Compose 配置文件,用于在容器中启动所有相关组件(如 Milvus 服务、Zookeeper、etcd 等)。

    下载官方的 docker-compose.yml 文件:

    bash 复制代码
    wget https://raw.githubusercontent.com/milvus-io/milvus/v2.3.0/docker/docker-compose.yml
  3. 启动 Milvus

    使用 Docker Compose 启动 Milvus 和相关的服务:

    bash 复制代码
    docker-compose -f docker-compose.yml up -d

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

  4. 检查 Milvus 状态

    确认 Milvus 服务已经启动,并运行正常:

    bash 复制代码
    docker-compose ps

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

  5. 访问 Milvus Web 界面

    通过浏览器访问 Milvus Web 界面(如果配置了),默认地址为:

    bash 复制代码
    http://localhost:3000

停止 Milvus

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

bash 复制代码
docker-compose down

方法二:从源代码安装 Milvus

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

前提条件

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

    安装 Go:

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

    设置 Go 环境变量:

    bash 复制代码
    export PATH=$PATH:/usr/local/go/bin
  2. 安装 CMake:Milvus 使用 CMake 构建,因此需要安装它。

    bash 复制代码
    sudo apt install cmake
  3. 安装 GCC 和 G++:

    bash 复制代码
    sudo apt-get install build-essential
  4. 安装 protobuf:

    bash 复制代码
    sudo apt-get install libprotobuf-dev protobuf-compiler

安装步骤

  1. 克隆 Milvus 仓库

    bash 复制代码
    git clone https://github.com/milvus-io/milvus.git
    cd milvus
  2. 构建 Milvus

    使用 CMake 构建 Milvus:

    bash 复制代码
    mkdir build
    cd build
    cmake ..
    make -j
  3. 启动 Milvus

    编译完成后,可以通过以下命令启动 Milvus:

    bash 复制代码
    ./milvus-server

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

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

安装步骤

  1. 下载 Milvus 二进制文件

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

  2. 解压文件

    下载完成后,解压文件:

    bash 复制代码
    tar -zxvf milvus-<version>.tar.gz
    cd milvus-<version>
  3. 启动 Milvus

    通过以下命令启动 Milvus:

    bash 复制代码
    ./milvus-server

检查 Milvus 是否运行正常

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

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

    bash 复制代码
    telnet localhost 19530
  2. 访问 Web 界面:如果启用了 Milvus 的 Web 界面,可以通过浏览器访问:

    bash 复制代码
    http://localhost:3000
  3. 查看日志:查看 Milvus 的日志输出,检查是否有错误信息。

    • Docker 容器日志:

      bash 复制代码
      docker logs milvus

常见问题

  • 问题:Milvus 服务无法启动,出现错误。

    • 解决 :检查 docker-compose 输出或查看日志,确认相关服务(如 Zookeeper、etcd)是否启动成功。
  • 问题:无法连接到 Milvus 的 API 或端口。

    • 解决 :确保防火墙和网络配置允许访问 19530 和其他端口。
  • 问题:如何配置 Milvus 的存储路径和其他参数?

    • 解决 :你可以在 docker-compose.yml 文件或源代码中修改 Milvus 配置文件,设置存储路径和其他参数。
相关推荐
腾飞开源4 小时前
03_Kubernetes 核心概念拆解:从 Spec/Status 收敛到工作负载控制器的设计逻辑
云原生·容器·kubernetes
Rocky Ding*4 小时前
【三年面试五年模拟】2026-11-05_月之暗面大模型算法岗一面、二面面经全解析
论文阅读·人工智能·深度学习·机器学习·aigc·强化学习·ai-native
Mirawork4 小时前
Mirawork v0.32.0 更新体验:会话引用、任务分享与音频转写怎么用
人工智能·音视频
lucas_AI5 小时前
模型一升级缓存全作废?DeepSeek 实测:KV Cache 跨版本直接复用,首 token 快 5 倍
人工智能
在所不辞兄5 小时前
【人工智能驱动的电催化研究-05】条件、循环与数据检查
人工智能·深度学习·神经网络·机器学习·有限元·电化学·电催化
IT_陈寒5 小时前
JavaScript项目实战经验分享:从内存泄漏到性能优化的血泪史
前端·人工智能·后端
小oo呆7 小时前
【自然语言处理与大模型】如何编写优质的Skill?
人工智能
非优秀程序员14 小时前
第12章 烧钱无底洞!!!不烧就死,烧了也不知道啥时候死|《互联网产品恩仇录》
人工智能
知已难寻15 小时前
Docker 入门:容器技术与 Docker 基础
java·运维·服务器·docker·云原生·容器
Zelman94515 小时前
第06章-交互与观察动作空间
人工智能