Docker 部署 Milvus 及 Attu 可视化工具完整指南

一、环境准备

安装 Docker 及 Docker Compose

• Docker 版本需 ≥20.10.12
• Docker Compose 版本需 ≥2.20.0（推荐 V2）

验证 Docker 环境

docker --version && docker-compose --version

若出现：-bash: docker-compose: command not found，则执行下述安装步骤

1. curl -SL https://gh-proxy.com/github.com/docker/compose/releases/download/v2.23.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
2. chmod +x /usr/local/bin/docker-compose
3. docker-compose --version

---

二、安装 Milvus 单机版

1. 下载官方 Compose 文件

mkdir milvus && cd milvus

# CPU单机版
wget https://github.com/milvus-io/milvus/releases/download/v2.3.0/milvus-standalone-docker-compose.yml -O docker-compose.yml
# GPU单机版
wget https://github.com/milvus-io/milvus/releases/download/v2.3.0/milvus-standalone-docker-compose-gpu.yml -O docker-compose.yml

2. 下载milvus.yml文件并配置
在文末通过attu进行修改milvus连接密码

wget https://raw.githubusercontent.com/milvus-io/milvus/v2.3.5/configs/milvus.yaml

修改配置文件开启鉴权：common -> security -> authorizationEnabled改为true

3. 修改docker-compose.yml，挂载自定义的milvus.yaml文件
找到：services -> standalone -> volumes添加如下内容：

volumes:- ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/milvus:/var/lib/milvus #原始内容不变- ${DOCKER_VOLUME_DIRECTORY:-.}/milvus.yaml:/milvus/configs/milvus.yaml #追加这行

/milvus/configs/milvus.yaml：容器内milvus.yaml文件位置

4. 启动 Milvus 服务

docker-compose up -d

5. 验证容器状态
预期输出三个容器

docker-compose ps

• Milvus 服务容器 （如 milvus-standalone）
  核心服务进程，处理向量数据的存储、索引和查询。
• etcd 容器 （如 milvus-etcd）
  用于元数据（Metadata）的存储与管理，如集合（Collection）、分区（Partition）等结构信息。
• MinIO 容器 （如 milvus-minio）
  对象存储服务，用于存储向量数据的持久化文件（如索引文件）

---

三、安装 Attu 可视化工具

1. 拉取并运行 Attu 镜像

docker run -d --name attu -p 18000:3000 \-e MILVUS_URL=host.docker.internal:19530 \--add-host=host.docker.internal:host-gateway zilliz/attu:v2.3.8

2. 访问attu并连接milvus
url：http://本机ip:18000
用户名：root
密码：Milvus

3. 修改Milvus密码