docker安装milvus向量数据库Attu可视化界面

news2025/3/20 18:22:09

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，则执行下述安装步骤

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
chmod +x /usr/local/bin/docker-compose
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