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 配置文件,设置存储路径和其他参数。
相关推荐
墨舟的AI笔记3 分钟前
React 组件库的 Tree Shaking:按需加载与副作用的工程化治理
人工智能
WoooChi1 小时前
DailyTech-20260724
人工智能·科技·业界资讯
zh路西法1 小时前
【CAM Grad-CAM Grad-CAM++】深度学习模型可解释性:从原理到YOLOv8部署实战
人工智能·深度学习·yolo·yolov8·grad-cam·cam
雨辰AI1 小时前
全集实战:企业级大模型服务化部署全栈指南|FastAPI 封装 + Nginx 负载均衡 + 高可用架构 从单机到生产一步到位
人工智能·ai·负载均衡·fastapi·ai编程
触底反弹1 小时前
Vibe Coding 不写 Git,等于悬崖边飙车
人工智能·git·面试
咖啡屋和酒吧2 小时前
健康管理:现代生活的科学守护
人工智能·生活·精选
星栈独行2 小时前
翻完 Pi 源码:它和 Codex、Claude Code 有何不同
开发语言·javascript·人工智能·程序人生
没有梦想的咸鱼185-1037-16632 小时前
AI-Python机器学习与深度学习技术:CNN/Transformer/扩散模型、SHAP可解释及Hermes智能体自动化
人工智能·python·深度学习·机器学习·chatgpt·cnn·transformer
船漏了就会沉2 小时前
Kimi K3 vs DeepSeek-V4:国产大模型的技术路线之争
人工智能
kirs_ur2 小时前
SSD 在 AI 训练中的角色
大数据·服务器·人工智能