Attu：Milvus向量数据库图形化管理工具完全指南

Attu是Milvus官方推出的专业图形化管理工具，为用户提供直观的可视化界面来管理和操作向量数据库。通过Attu，用户可以轻松完成数据库架构设计、数据操作、向量搜索等复杂任务，大大降低了Milvus的学习和使用门槛。

Attu核心功能特性

Attu提供全面的Milvus管理功能，让向量数据库操作变得简单高效：

• 数据库、集合和分区管理：通过图形化界面快速组织和管理数据库结构，简化Milvus环境的构建和导航
• 向量数据操作：支持向量数据的插入、索引构建和查询，使用户能够高效处理向量数据
• 高级搜索功能：提供高性能的向量搜索能力，快速找到相似项，便于功能验证
• 用户和角色管理：管理用户和角色权限，确保系统安全和受控访问
• 系统监控与分析：查看系统配置、监控慢请求，跟踪各类系统任务和性能指标

系统环境要求

在使用Attu之前，请确保满足以下系统要求：

• Docker 20.10.0或更高版本
• Kubernetes 1.19或更高版本（如需K8s部署）
• 现代网页浏览器（Chrome、Firefox、Safari、Edge）
• 桌面应用程序要求：
  • Windows 10/11
  • macOS 10.15或更高版本
  • Linux（Ubuntu 20.04或更高版本）

快速入门指南

环境准备与启动

1. 启动Milvus服务器（如尚未运行）：

docker run -d --name milvus_standalone -p 19530:19530 -p 9091:9091 milvusdb/milvus:latest

2. 启动Attu管理界面：

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

3. 打开浏览器访问 http://localhost:8000 即可开始使用Attu

主要功能界面展示

Attu的首页连接界面，支持多种连接配置和数据库选择

数据管理界面，提供集合管理、数据预览和操作功能

向量搜索界面，支持多种搜索条件和结果可视化

系统监控面板，展示集群拓扑和性能指标

详细安装配置

Docker部署方式

通过Docker运行Attu是最简单快捷的方式：

docker run -p 8000:3000 -e MILVUS_URL={milvus server IP}:19530 zilliz/attu:v2.5

确保Attu容器能够访问Milvus服务器的IP地址。启动后，在浏览器中输入 http://{ Attu IP }:8000 即可访问Attu图形界面。

环境变量配置

Attu Docker容器支持以下可选环境变量：

参数	示例	必填	描述
MILVUS_URL	192.168.0.1:19530	否	Milvus服务器URL
DATABASE	your database	否	默认数据库名称
ATTU_LOG_LEVEL	info	否	设置Attu日志级别
ROOT_CERT_PATH	/path/to/root/cert	否	根证书路径
PRIVATE_KEY_PATH	/path/to/private/key	否	私钥路径
CERT_CHAIN_PATH	/path/to/cert/chain	否	证书链路径
SERVER_NAME	your_server_name	否	服务器名称
SERVER_PORT	Server listen port	否	默认3000

Kubernetes部署

在Kubernetes环境中部署Attu：

kubectl apply -f https://raw.githubusercontent.com/zilliztech/attu/main/attu-k8s-deploy.yaml

确保Attu pod能够访问Milvus服务。在提供的示例中，这将直接连接到 my-release-milvus:19530。

桌面应用程序

对于偏好桌面应用的用户，可以下载Attu桌面版本。如果在Mac M芯片上安装遇到问题，可执行：

sudo xattr -rd com.apple.quarantine /Applications/attu.app

开发环境搭建

开发前提条件

• Node.js 16.x或更高版本
• Yarn包管理器
• Docker（用于本地开发）

本地开发设置

1. 克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/at/attu
cd attu

2. 安装项目依赖：

yarn install

3. 启动开发服务器：

yarn start

构建与测试

• 开发版本构建：yarn run build:dev
• 发布版本构建：yarn run build:release
• 运行测试：yarn test

版本兼容性

Milvus版本	推荐的Attu版本
2.6.x	v2.6.1
2.5.x	v2.5.10
2.4.x	v2.4.12
2.3.x	v2.3.5
2.2.x	v2.2.8
2.1.x	v2.2.2

常见问题解答

• 无法登录系统：确保Milvus服务器的IP地址可以从Attu容器访问
• Mac OS安装问题：参考桌面应用程序安装说明
• 如何更新Attu：Docker用户拉取最新镜像重启容器，桌面用户下载最新版本
• 配置备份：Attu配置存储在浏览器本地存储中，可从设置页面导出

许可证信息

Attu 2.5采用Apache License 2.0许可证，Attu 2.6为闭源版本。

通过Attu，您可以充分发挥Milvus向量数据库的强大功能，无论是数据科学家、开发人员还是数据库管理员，都能从Attu直观高效的界面中获益，让向量数据库管理变得简单而愉快。