Milvus 安装和启动指南

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


方法一:使用 Docker 安装 Milvus

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

前提条件

  1. 安装了 DockerDocker 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. 安装 GCCG++

    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 配置文件,设置存储路径和其他参数。
相关推荐
CV-杨帆7 分钟前
ICLR 2026 LLM安全相关论文整理
人工智能·深度学习·安全
田八14 分钟前
聊聊AI的发展史,AI的爆发并不是偶然
前端·人工智能·程序员
zandy101115 分钟前
全链路可控+极致性能,衡石HENGSHI CLI重新定义企业级BI工具的AI协作能力
大数据·人工智能·ai analytics·ai native·agent-first
广州灵眸科技有限公司16 分钟前
为RK3588注入澎湃算力:RK1820 AI加速卡完整适配与评测指南
linux·网络·人工智能·物联网·算法
小程故事多_8017 分钟前
从零吃透Transformer核心,多头注意力、残差连接与前馈网络(大白话完整版)
人工智能·深度学习·架构·aigc·transformer
xiejava101819 分钟前
写了一个WebDAV的Skill解决OpenClaw AI助手跨平台协作难题
人工智能·ai编程·智能体·openclaw
zhanghongbin0125 分钟前
AI 采集器:Claude Code、OpenAI、LiteLLM 监控
java·前端·人工智能
AI应用实战 | RE28 分钟前
012、检索器(Retrievers)核心:从向量库中智能查找信息
人工智能·算法·机器学习·langchain
IT_陈寒30 分钟前
Python的列表推导式里藏了个坑,差点让我加班到凌晨
前端·人工智能·后端
Thomas.Sir33 分钟前
AI 医疗之罕见病/疑难病辅助诊断系统从算法到实现【表型驱动与知识图谱推理】
人工智能·算法·ai·知识图谱