一、环境准备
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-standalone | Milvus 主进程 | 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.