文章目录
- 一、准备工作
- [二、下载 Milvus Docker Compose 文件](#二、下载 Milvus Docker Compose 文件)
- [三、修改配置对接现有 MinIO](#三、修改配置对接现有 MinIO)
- [四、启动 Milvus](#四、启动 Milvus)
- [五、验证 Milvus 是否正常运行](#五、验证 Milvus 是否正常运行)
Milvus 是一款开源的向量数据库,专为大规模 AI、搜索与推荐场景设计,用于管理和快速检索海量特征向量数据。Milvus 支持 Docker 容器化部署,并可与 MinIO 兼容 S3 的对象存储集成,用于持久化向量索引和数据文件等内容。
一、准备工作
环境需求
你需要具备以下环境与工具:
- 已安装 Docker + Docker Compose;
- 已运行可访问的 MinIO 服务(例如 localhost:9000);
- 已创建用于 Milvus 的 MinIO bucket(例如
a-bucket)。
Milvus 在 MinIO/S3 中存储数据的 bucket 需要是已经存在或可被创建的。
二、下载 Milvus Docker Compose 文件
Milvus 官方提供了用于单机版部署的 docker-compose 文件。我们将它保存到本地:
bash
mkdir -p ~/milvus
cd ~/milvus
# 下载最新的 standalone Docker Compose 配置
wget https://github.com/milvus-io/milvus/releases/download/v2.6.9/milvus-standalone-docker-compose.yml -O docker-compose.yml
⚠ 这里使用官方提供的 standalone 版本,是适合单节点环境的快速部署方式。
三、修改配置对接现有 MinIO
默认的 docker-compose 文件中会包含一个 MinIO 服务。但你已经有自己的 MinIO,因此需要做以下调整:
修改 Docker Compose
打开 docker-compose.yml:
- 注释掉或删除默认的 MinIO 服务块
- 确保 standalone 服务部分使用你的 MinIO 地址
示例片段:
yaml
services:
# 这里注释掉官方的 MinIO 部分
# minio:
# image: minio/minio
# ...
milvus-standalone:
image: milvusdb/milvus:v2.6.9
environment:
ETCD_ENDPOINTS: etcd:2379
MINIO_ADDRESS: 192.168.121.140:9000
MINIO_ACCESS_KEY_ID : admin
MINIO_SECRET_ACCESS_KEY: admin123456
MINIO_BUCKET_NAME: sky-public
MINIO_USE_SSL: "false"
MQ_TYPE: rocksmq
depends_on:
- etcd
ports:
- "19530:19530"
- "9091:9091"
⚠ 确保以下参数对应你的 MinIO:

四、启动 Milvus
完成配置后,在同一目录运行:
bash
# 拉取镜像
docker compose pull
# 启动容器
docker compose up -d
# 查看容器健康状态
docker compose ps
如果一切配置正确:
- Milvus gRPC 接口监听在 19530
- Milvus Web UI 监听在 9091
你可以在浏览器中访问 Web UI(例如 http://192.168.121.140:9091/healthz)检查运行状态和健康指标。
五、验证 Milvus 是否正常运行
