Milvus 可视化管理利器：Attu 全面指南

原创于 2025-11-04 20:00:00 发布 · 1.3k 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#milvus #attu #向量数据库

Milvus 专栏收录该内容

2 篇文章

订阅专栏

在向量数据库的实践中，Milvus 以其高性能、高可用的特性成为主流选择，但命令行操作和复杂的配置的让不少开发者望而却步。Attu（zilliztech/attu）作为 Milvus 官方推荐的图形化管理工具，完美解决了这一痛点 —— 它将 Milvus 的核心功能封装为直观的可视化界面，让向量数据库的管理、操作和监控变得简单高效。本文将全面解析 Attu 的核心功能、部署方式和使用场景。

Attu 核心解析：Milvus 的可视化操作面板

Attu 是 Zilliz 推出的开源（低版本）/ 专有（高版本）图形化工具，专为 Milvus 设计，核心定位是 “降低 Milvus 使用门槛，提升开发与运维效率”。无论是新手入门还是生产环境运维，Attu 都能成为你的得力助手。

核心功能：覆盖 Milvus 全生命周期管理

Attu 的功能围绕 Milvus 的核心操作展开，无需编写代码即可完成绝大多数任务：

数据管理：可视化创建 / 删除 Collection（集合）、Partition（分区），支持 Schema 设计（字段类型、向量维度、主键设置等）。
向量操作：批量导入 / 导出向量数据，手动插入单条向量，支持索引创建（HNSW、IVF、SPARSE_INVERTED_INDEX 等）和参数配置。
检索验证：快速执行向量搜索、混合检索，实时查看 Top-K 结果和相似度得分，支持标量过滤条件（如category = "dragon"）。
权限控制：用户与角色管理，支持细粒度权限分配（如只读权限、读写权限、管理员权限），保障生产环境安全。
系统监控：查看 Milvus 集群状态、慢查询跟踪、任务执行日志，监控检索延迟、吞吐量等核心性能指标。

部署指南：3 种方式快速上手

Attu 支持 Docker、Kubernetes、桌面应用等多种部署方式，满足不同场景需求，新手推荐 Docker 或桌面版，生产环境推荐 K8s 部署。

如果没有启动milvus，可以用docker启动：

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

Docker 部署

无需复杂配置，一条命令即可启动，适合快速验证和开发环境：

# 核心命令（替换{milvus IP}为你的Milvus服务地址）
docker run -p 8000:3000 -e MILVUS_URL={milvus IP}:19530 zilliz/attu:v2.6

端口映射：容器内 3000 端口映射到本地 8000 端口，访问http://localhost:8000即可进入界面。
环境变量扩展：支持配置日志级别（LOG_LEVEL=info）、SSL 证书（SSL_CERT_PATH=/path/cert）、登录密码（ATTU_PASSWORD=your_pwd）等。

桌面应用部署

直接下载安装包，无需 Docker，支持 Windows、macOS、Linux：

下载地址：Attu 官方下载页
注意事项：
- Mac（M 系列芯片）若遇无法打开问题/安装打开提示校验不通过，执行命令sudo xattr -rd com.apple.quarantine /Applications/attu.app即可。
- 安装后直接输入 Milvus 地址（如localhost:19530），无需额外配置。

Kubernetes 部署

适合 Milvus 集群部署场景，通过 YAML 文件实现高可用部署：

apiVersion: v1
kind: Service
metadata:
  name: my-attu-svc
  labels:
    app: attu
spec:
  type: NodePort  # 改为 NodePort 类型，允许外部访问
  ports:
  - name: attu
    protocol: TCP
    port: 3000          # Service 内部端口（不变）
    targetPort: 3000    # 容器端口（不变）
    nodePort: 30080     # 可选：指定节点端口（30000-32767 之间），不指定则自动分配
  selector:
    app: attu

部署命令：kubectl apply -f https://raw.githubusercontent.com/zilliztech/attu/main/attu-k8s-deploy.yaml，访问http://{K8s节点IP}:30080即可。

关键注意事项

兼容性匹配

Attu 与 Milvus 版本强绑定，不同 Milvus 版本需选择对应 Attu 版本：

Milvus 版本	推荐 Attu 版本	许可证类型
2.6.x	v2.6.0+	专有许可证（禁止修改源码）
2.5.x	v2.5.10	Apache License 2.0（开源）
2.4.x 及以下	v2.4.5	Apache License 2.0（开源）

注：2.6.0 以上版本为专有许可证，仅允许使用官方二进制文件；若需二次开发，建议选择 v2.5.12 及以下开源版本。

开发与二次定制

若需基于 Attu 源码定制功能（仅开源版本支持）：

开发依赖：Node.js 16.x+、Yarn、Docker

开发步骤：

# 1. 克隆仓库
git clone https://github.com/zilliztech/attu.git
cd attu
# 2. 安装依赖
yarn install
# 3. 启动开发服务器（默认端口3000）
yarn start
# 4. 构建Docker镜像
yarn run build:dev  # 开发版
# yarn run build:release  # 发布版