Attu 与 Milvus 可视化运维
Attu 是 Milvus 的可视化管理工具：可以查看集合、schema 与索引，做数据浏览与相似度检索，并观察系统拓扑与慢查询。它的主要价值在排查与演示——肉眼确认数据长什么样、按同一条向量检索返回了什么。生产变更仍建议走脚本与评审，避免可视化界面里的一次误操作直接落到线上。
基本信息
| 部署方式 | Docker 单容器 |
|---|---|
| 连接方式 | 通过环境变量指定 Milvus 服务地址 |
| 端口 | 容器内 3000，映射到宿主常用 8000 |
| 主要能力 | 集合与 schema 浏览、数据查询、相似度检索、拓扑与慢查询 |
| 鉴权 | 默认无鉴权，依赖网络隔离保障 |
| 定位 | 排查与演示，不替代脚本化变更 |
典型使用场景
- 排查「检索为什么返回这一条」：按同一条向量复现一次
- 核对写入是否符合预期，检查条数与字段取值
- 检查 schema 与索引配置是否与设计文档一致
- 演示与培训时直观展示集合结构
- 观察慢查询与系统拓扑，辅助容量判断
Docker 启动 Attu
Docker 启动 Attu
docker run -d --name attu -p 8000:3000 \
-e MILVUS_URL=http://host.docker.internal:19530 \ # 指向 Milvus 服务
zilliz/attu:latest
# 浏览器访问 http://localhost:8000
# 默认无鉴权：不要把端口直接暴露到公网使用要点读法
| 要点 | 说明 | 风险 |
|---|---|---|
| 连接配置 | 地址指向 Milvus 服务 | 地址写错会连到别的库，结论失真 |
| 端口映射 | 容器 3000 映射到宿主 | 暴露公网且无鉴权时数据可被读写 |
| 数据浏览 | 可视化查看集合内容 | 大批量浏览会占用在线检索资源 |
| 变更操作 | 界面可执行部分管理动作 | 生产变更应走脚本与评审，便于追溯 |
Attu 默认无鉴权：不要直接暴露公网，放在内网并配合反向代理与访问控制更稳妥。
排查顺序建议：先在 Attu 里用同一条查询向量复现，确认是索引与数据的问题，还是上游传参的问题，再去改配置。