Linux部署Milvus数据库及Attu UI工具完全指南

原创已于 2025-08-11 09:08:01 修改 · 1k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#LLM #大模型 #milvus

于 2025-07-16 09:10:25 首次发布

一、准备工作

1.1 环境要求

操作系统：Ubuntu 20.04/Debian 11/CentOS 7+
硬件配置：至少8GB内存，4核CPU，50GB磁盘空间
网络要求：可访问互联网（用于拉取Docker镜像）

1.2 安装Docker和Docker Compose

1.2.1 安装Docker

sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker

1.2.2 验证Docker安装

docker --version
sudo docker run hello-world

1.2.3 安装Docker Compose

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

1.2.4 验证Docker Compose安装

docker-compose --version

二、部署Milvus数据库

2.1 创建部署目录

mkdir -p /opt/milvus
cd /opt/milvus

2.2 下载官方Docker Compose配置文件

wget https://github.com/milvus-io/milvus/releases/download/v2.5.10/milvus-standalone-docker-compose.yml -O docker-compose.yml

2.3 启动Milvus服务

sudo docker-compose up -d

2.4 验证Milvus服务状态

sudo docker-compose ps

正常输出应显示三个容器（milvus-etcd、milvus-minio、milvus-standalone）均为"Up"状态

2.5 查看Milvus日志

sudo docker-compose logs -f milvus-standalone

2.6 测试Milvus端口连通性

nc -zv localhost 19530

三、部署Attu可视化管理工具

3.1 使用Docker启动Attu

docker run -d --name milvus-attu \
  -p 8000:3000 \
  -e MILVUS_URL=localhost:19530 \
  zilliz/attu:v2.5

3.2 验证Attu容器状态

docker ps | grep attu

四、访问与使用

4.1 访问Attu管理界面

打开浏览器访问：

http://服务器IP:8000

4.2 连接Milvus数据库

在登录页面输入Milvus服务地址：http://服务器IP:19530
点击"连接"按钮（默认无需用户名密码）

4.3 基本操作指南

创建数据库：点击"创建数据库"，输入名称即可
创建集合：设置集合名称、向量维度和索引类型
导入数据：支持JSON/CSV文件批量导入
向量搜索：输入查询向量，设置搜索参数执行相似性搜索

五、常用操作命令

5.1 停止Milvus服务

cd /opt/milvus sudo docker-compose down

5.2 启动Milvus服务

cd /opt/milvus sudo docker-compose up -d

5.3 重启Attu服务

docker restart milvus-attu

5.4 查看Milvus数据目录

ls -la /opt/milvus/volumes

六、注意事项

6.1 版本兼容性

Attu版本需与Milvus版本匹配，例如Attu v2.5对应Milvus 2.5.x
查看Milvus版本：docker images | grep milvusdb/milvus

6.2 国内镜像源配置

若拉取镜像缓慢，可配置Docker国内镜像源：

sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

6.3 防火墙设置

开放必要端口：

sudo ufw allow 19530/tcp
sudo ufw allow 8000/tcp
sudo ufw reload

6.4 数据备份

定期备份Milvus数据目录：

cp -r /opt/milvus/volumes /opt/milvus/volumes_backup_$(date +%Y%m%d)

七、问题排查

7.1 Milvus启动失败

检查系统资源是否充足：

free -h df -h

7.2 Attu无法连接Milvus

检查网络连通性：

telnet 服务器IP 19530

7.3 查看详细日志

sudo docker-compose logs --tail=100 milvus-standalone 
docker logs milvus-attu

八、总结

通过Docker Compose方式部署Milvus和Attu是最简单高效的方法，适合开发测试和中小型生产环境。本文详细介绍了从环境准备到服务部署的完整流程，包括常用操作命令和问题排查方法。如有进一步需求，可参考Milvus官方文档进行分布式部署或高级配置。