mac 安装 Milvus 向量数据库

📅 2026/8/3 5:58:08 👁️ 阅读次数 📝 编程学习
mac 安装 Milvus 向量数据库

一、环境准备

1.1 前置条件

  • Docker Desktop(已安装并运行)
  • Python 3.x(用于 pymilvus 客户端)

验证 Docker 正在运行:

dockerinfo

二、安装 Milvus Standalone

2.1 创建工作目录并下载官方 docker-compose 配置

mkdir-p~/milvus-standalonecd~/milvus-standalonecurl-Lhttps://github.com/milvus-io/milvus/releases/download/v2.5.4/milvus-standalone-docker-compose.yml\-odocker-compose.yml

下载完成后,docker-compose.yml内容包含三个服务:

容器名用途端口
milvus-etcd元数据存储(Raft 协调)2379-2380(内部)
milvus-minio对象存储(持久化向量数据)9000(API)、9001(Web UI)
milvus-standaloneMilvus 主进程19530(gRPC/SDK)、9091(HTTP/健康检查)

2.2 启动所有服务

cd~/milvus-standalonedockercompose up-d

实际输出(精简):

Image quay.io/coreos/etcd:v3.5.16 Pulled Image minio/minio:RELEASE.2023-03-20T20-16-18Z Pulled Image milvusdb/milvus:v2.5.4 Pulled Container milvus-etcd Started Container milvus-minio Started Container milvus-standalone Started

首次执行会拉取三个镜像,总大小约 700MB,根据网速需等待数分钟。

2.3 等待服务健康

# 等待约 30 秒后检查容器状态sleep30dockerps--format"table { {.Names}}\t{ {.Status}}\t{ {.Ports}}"|grepmilvus

实际输出:

milvus-standalone Up 37 seconds (healthy) 0.0.0.0:9091->9091/tcp, 0.0.0.0:19530->19530/tcp milvus-minio Up 37 seconds (healthy) 0.0.0.0:9000-9001->9000-9001/tcp milvus-etcd Up 37 seconds (healthy) 2379-2380/tcp

三个容器都显示(healthy)即为成功。

2.4 验证健康状态

curlhttp://localhost:9091/healthz# 输出:OK

三、访问 Web UI 管理界面

在浏览器打开:

http://127.0.0.1:9091/webui/

可以可视化查看 Collections、查询数据、监控集群状态。

MinIO 控制台(查看存储文件):

http://127.0.0.1:9001 # 用户名/密码:minioadmin / minioadmin

四、安装 Python 客户端

pip3installpymilvus

实际安装版本:pymilvus 3.0.0


五、Python 使用示例

5.1 连接 Milvus

frompymilvusimportMilvusClient client=MilvusClient(uri="http://localhost:19530")print("连接成功!")

5.2 创建 Collection(向量表)

COLLECTION="demo_standalone"# 如果已存在则先删除ifclient.