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 配置文件,设置存储路径和其他参数。
相关推荐
sell-cloud7 小时前
Prompt Engineering要凉了?Fable 5.5能“猜“意图,但银行正在封杀AI Agent——企业AI的真正护城河是什么
人工智能·prompt
Navicat中国8 小时前
Navicat 18 内置 AI 助手让数据库开发从繁琐操作迈向智能协作
大数据·人工智能·数据库开发
4SAPI8 小时前
多模型请求路由怎么设计?成本、速度和能力如何平衡
人工智能·python·gateway·php
魔乐社区9 小时前
翼芯・智算测试与适配优化专区,让国产算力“选得准、跑得通、用得好“
人工智能·开源·大模型
Liaiyang6610 小时前
空圈容错:从 (0, 1) 夹缝本体论到 11 次跨域盲测
ai·大模型·量子力学·科学哲学·宇宙学·认识论·认知边界
XCDoris11 小时前
郴州logo设计机构
大数据·人工智能·python
Goboy11 小时前
一个人带三个Agent,我用全新TRAE从0到1搭了个资讯周刊站
人工智能·trae
俊哥V11 小时前
每日 AI 研究简报 · 2026-10-19
人工智能·ai
AI_AGENT_DEV_AI11 小时前
AI英语教培智能体的开发
人工智能
物联网软硬件开发-轨物科技11 小时前
【技术白皮书】光伏清检一体化机器人系统解决方案技术白皮书
大数据·运维·网络·人工智能·机器人