📌 Attu — Milvus 最佳图形化管理界面(GUI)
Attu 是 Milvus 向量数据库的旗舰管理工具,通过 可视化界面 让你轻松管理 Milvus,从架构设计到运维监控都支持。
⭐ 功能亮点
🗂 全面的数据与模式管理
-
可视化模式设计器 通过直观 UI 设计、查看和修改集合(Collection)模式,支持快速预览字段细节。
-
生命周期控制 轻松管理多个数据库、集合及其属性,支持克隆、配置和批量操作。
-
智能数据操作 强大的数据管理功能:智能过滤、语法高亮、完整数据视图、内联编辑,以及导入/导出能力。
🧰 交互式开发工具
-
向量相似度搜索可视化 支持以可视方式执行向量搜索并查看结果。
-
基于表达式的快速数据查询 提供高级查询表达式支持,提高数据检索效率。
-
REST API 编辑器内置 方便调试和调用 Milvus REST 接口。
🔐 企业级安全与监控
-
可视化 RBAC(角色访问控制)与权限组管理 让权限策略一目了然。
-
实时系统监控 节点(Node)、段(Segment)、任务(Task)等状态实时展示。
-
慢查询分析 & 系统诊断 内置性能分析工具帮助优化数据库表现。
-
详细段查询与检查 对每个向量段提供深入查询结果分析。
📋 目录结构(README 内容概览)
- 功能特性(Features)
- 系统要求(System Requirements)
- 快速开始(Quick Start)
-
安装指南(Installation Guides)
- 兼容性说明
- Docker 运行方式
- Kubernetes 部署方式
- Nginx 反向代理配置
- 桌面应用安装
- 开发指南
- 贡献说明
- 常见问题(FAQ)
- 更多截图
- 示例与实用教程
- Milvus 相关链接
- 社区与支持信息
🧠 系统要求
- Docker 20.10.0 或更新版本
- Kubernetes 1.19 或更新版本(如采用 K8s 部署)
- 现代浏览器(Chrome / Firefox / Safari / Edge)
-
桌面版(可选)支持:
- Windows 10/11
- macOS 10.15+
- Linux Ubuntu 20.04+
🚀 快速开始
- 启动 Milvus 服务器(如果尚未运行):
docker run -d --name milvus_standalone -p 19530:19530 -p 9091:9091 milvusdb/milvus:v2.6.9
curl -s https://registry.hub.docker.com/v2/repositories/milvusdb/milvus/tags?page_size=10 grep '"name"' | head -n 10
- 启动 Attu:
docker run -p 8000:3000 -e MILVUS_URL=localhost:19530 zilliz/attu:v2.6.3
- 在浏览器中访问:
http://localhost:8000
``` :contentReference[oaicite:14]{index=14}
---
## 🛠 安装指南
### 📌 兼容性对照
| Milvus 版本 | 推荐 Attu 版本 |
|-------------|----------------|
| 2.6.x | v2.6.3 |
| 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 | :contentReference[oaicite:15]{index=15}
---
### 🐳 Docker 运行方式
启动 Attu 容器:
```bash
docker run -p 8000:3000 \
-e MILVUS_URL={Milvus 服务地址}:19530 \
zilliz/attu:v2.6
注意:容器内部必须能够访问 Milvus 服务地址,否则无法登录。
🍃 可选环境变量示例
| 环境变量 | 示例 | 描述 | |
|---|---|---|---|
| MILVUS_URL | 192.168.0.1:19530 | Milvus 服务器地址 | |
| DATABASE | your database | 默认数据库 | |
| ATTU_LOG_LEVEL | info | 日志级别 | |
| ROOT_CERT_PATH | /path/to/root/cert | TLS 根证书 | |
| PRIVATE_KEY_PATH | /path/to/private/key | 客户端私钥 | |
| CERT_CHAIN_PATH | /path/to/cert/chain | TLS 证书链 | |
| SERVER_NAME | your_server_name | 服务器名称 | |
| SERVER_PORT | 端口号(默认 3000) | 监听端口 |
🚢 Kubernetes 部署
确保你的 Milvus 已经运行在 Kubernetes 集群中,然后执行:
kubectl apply -f \
https://raw.githubusercontent.com/zilliztech/attu/main/attu-k8s-deploy.yaml
确保 Attu Pod 能访问 Milvus 服务。
📦 桌面应用
Attu 提供跨平台桌面应用(Windows / macOS / Linux)。下载并安装对应平台的安装包即可。
注意: macOS M系列芯片安装包可能报“损坏”错误,需要移除隔离标记才能打开。
❓ 常见问题(FAQ)
-
无法登录? 确认 Milvus 服务地址在 Attu 容器/机器中是可访问的(localhost 在容器中不适用)。
-
如何更新 Attu? Docker 用户只需拉取最新镜像并重启。桌面版用户下载最新发布版本即可。
-
如何备份配置? Attu 的配置存储在浏览器本地存储中,可以从设置界面导出。
🔗 相关资源
- Milvus 官方文档
- Milvus Python / Java / Go / Node SDK
- 向量搜索可视化工具和示例实用工具(如 Feder)
📜 关于许可证
从 v2.6.0 版本起,Attu 不再是开源软件(采用专有许可)。v2.5.x 及之前版本仍遵循 Apache 2.0 许可。
如果你需要,我也可以 逐段翻译 README_CN.md(项目自带的中文 README),并帮你整理成更易懂的中文文档。
参考资料
https://github.com/zilliztech/attu?tab=readme-ov-file#attu
