部署Milvus单机版时，Docker Compose几乎是绕不开的标配路径。它的核心优势，在于将etcd、MinIO、Milvus这三个紧密耦合的组件，从网络、存储到启动顺序都统一管理起来。如果选择手动部署，光是健康检查的时序错乱，就足以让你反复陷入“连接超时”和“context deadline exceeded”的错误提示中，耗费大量时间。
至于源码编译，在普通的生产环境中既无必要，也容易踩坑。尤其对于没有维护过C++项目的开发者来说，make milvus失败十次有九次是卡在knowhere或faiss的编译环节。因此，直接采用Docker Compose是最稳妥、最高效的选择。
为什么 Docker Compose 是首选安装方式
官方早已将standalone模式作为默认推荐，v2.5之后的版本更是彻底弃用了旧版的单机二进制部署。原因在于：这三个组件环环相扣，手动拉起时很难精确对齐它们的启动与就绪状态。你遇到的那些连接异常，根源往往是etcd启动得比Milvus初始化时的重试窗口还要慢。
- 统一管理：所有服务（etcd/minio/milvus）的网络、卷挂载和启动顺序都由Compose一手包办，无需人工干预。
- 健康检查是关键：
healthcheck配置必须保留，否则milvus-standalone容器会在etcd尚未就绪时直接报错退出。 - 网络地址别搞错：
ETCD_ENDPOINTS务必保持为etcd:2379，若改为localhost:2379会失效，因为容器内的localhost并不指向宿主机。 - 资源限制要留意：如果机器内存低于6GB，建议在
milvus.yaml中适当调低cache.memoryLimit，否则OOM killer可能优先杀死etcd进程。
docker-compose.yml 必须修改的关键项
从官网下载的milvus-standalone-docker-compose.yml默认是个“黑盒”：既不带Attu可视化界面，也不暴露配置文件路径。直接运行后若出现问题，排查极为困难。因此，有两处修改是必须的：
- 挂载配置文件：在
standalone服务下，添加卷挂载：./milvus.yaml:/milvus/configs/milvus.yaml。若不挂载，你对配置文件的任何修改都不会生效。 - 添加Attu服务：新增一个
attu服务块，使用官方镜像如zilliz/attu:v2.6.0，并将端口映射为8080:3000，从而获得可视化管理界面。 - MinIO地址要写对：
MINIO_ADDRESS必须写成minio:9000，而不是localhost:9000或127.0.0.1:9000。 - 数据持久化：如果需要持久化数据，建议将
${DOCKER_VOLUME_PATH:-./volumes/milvus/db}这样的相对路径变量替换为绝对路径，例如/opt/milvus/db，这样更清晰且不易出错。
启动后连不上 19530 端口的常见原因
遇到连接失败，先别急着检查防火墙。90%的情况是容器网络或健康检查失败，导致Milvus进程根本没有启动。按顺序执行以下步骤：
- 首先，执行
docker-compose ps，查看各个容器的状态。 - 然后，查看日志：运行
docker-compose logs -f standalone。如果反复出现failed to create etcd client，说明etcd未通过健康检查。可以等待两分钟再试，或者直接删除volumes重新启动。 - 使用
curl https://localhost:19530/version测试；若返回空或connection refused，重点检查standalone容器的状态是否为Up (healthy)，而非Up (unhealthy)。 - 使用宝塔面板的用户请注意：宝塔自带的防火墙默认可能禁用了19530和9000端口，需要手动放行。
- 云服务器（如阿里云、腾讯云）用户务必检查安全组规则。仅开放19530端口可能不够，Attu需要8080端口，MinIO控制台则需要9001端口。
配置 milvus.yaml 的几个硬性限制
配置文件中的很多参数看似可调，但背后存在隐含约束。例如，若将storage.type改为s3却未在storage.s3下配置access key，服务会直接崩溃。又如，将queryNode.scheduler.maxTaskNum设得过高，可能导致querynode进程内存暴涨。
- 必须开启压缩：
dataCoord.enableCompaction在standalone模式下必须设为true，否则数据段（segment）不会合并，磁盘占用将持续增长。 - 注意单位：
common.retentionDuration的单位是秒，而非小时。设置成86400，才代表数据保留1天。 - GPU加速：若需启用GPU加速，需额外拉取
milvusdb/milvus:v2.6.0-gpu镜像，并在standalone服务中增加runtime: nvidia以及环境变量GPU_ENABLED: true。 - 日志级别慎用：将日志级别设为
debug会显著拖慢写入性能，仅在排查问题时临时开启。
归根结底，部署的难点从来不是把软件装上，而是让etcd、minio、milvus这三个容器在资源有限的机器上，按照正确的顺序、携带正确的参数、采用正确的网络模式，一起稳定地运行起来。紧盯docker-compose ps输出中的healthy标签，比任何复杂的调试手段都更管用。
