Docker Compose 是官方推荐的 Milvus 部署方式,需修改三处关键配置:挂载 milvus.yaml、新增 attu 可视化服务、正确设置 MINIO_ADDRESS 为 minio:9000;启动前须确认容器状态为 Up (healthy),内存不足时需调低 cache.memoryLimit 避免 OOM。

官方从 v2.5 起已弃用单机二进制包,make milvus 在普通环境里失败率极高:90% 是 knowhere 编译卡在 AVX 指令集检测,或是 faiss 链接 OpenBLAS 失败。而 Docker Compose 启动的 milvusdb/milvus 镜像,是预编译、预验证过的完整运行时,连 etcd 和 minio 的健康检查时序都对齐好了。
docker-compose.yml 必须改的三处
官网下载的 milvus-standalone-docker-compose.yml 是“能跑但不好用”的默认版,不改就等于裸奔:
-
standalone服务下必须加挂载:./milvus.yaml:/milvus/configs/milvus.yaml,否则改任何配置(比如cache.memoryLimit)都无效 - 新增
attu服务块,镜像用zilliz/attu:v2.6.0,端口映射写成8080:3000,不然没法可视化查集合和向量 -
MINIO_ADDRESS环境变量必须设为minio:9000,不是localhost:9000或127.0.0.1:9000——容器内localhost指自己,不是宿主机
启动后连不上 19530 端口?先看容器状态
90% 的 “connection refused” 不是防火墙问题,而是 milvus-standalone 容器根本没进 healthy 状态:
- 执行
docker-compose ps,确认standalone显示的是Up (healthy),不是Up (unhealthy)或反复重启 - 如果日志里持续出现
failed to create etcd client,说明etcd还没通过 healthcheck,等满 2 分钟再试,或删掉 volumes 重跑:docker-compose down -v && docker-compose up -d -
curl http://localhost:19530/version返回空或超时 → 直接看docker-compose logs -f standalone,重点搜panic、OOMKilled、context deadline exceeded
内存低于 8GB 的机器要调低 cache 阈值
默认配置会尝试占用 4GB 内存做向量缓存,小内存机器(比如宝塔面板装在 4GB VPS 上)大概率触发 OOM killer,干掉 etcd 导致整个链路崩:
- 编辑挂载的
milvus.yaml,找到cache:段,把memoryLimit: 4GB改成memoryLimit: 1GB - 同时把
maxCacheSize: 4GB也同步调低,避免索引加载失败 - 改完别忘了
docker-compose restart standalone,只重启 milvus,不用动 etcd/minio
最常被忽略的一点:宝塔用户必须手动放行 19530 和 9000 端口——它自带的防火墙默认全封,和系统 firewalld 无关;另外,ETCD_ENDPOINTS: etcd:2379 这个值绝对不要手贱改成 localhost:2379,这是容器网络里最典型的“本地环回陷阱”。

















