Docker 安装 Attu 的保姆级部署文档_Docker部署Attu步骤

✅ 环境准备

1. 安装 Docker 和 Docker Compose

   • Windows 用户：安装 Docker Desktop。

   • Linux/macOS 用户：通过官方文档安装 Docker 和 Docker Compose：

     • Docker 官方安装指南

     • Docker Compose 安装指南

2. 验证安装

   # 检查 Docker 是否安装成功docker --version# 检查 Docker Compose 是否安装成功docker-compose --version

   • 输出示例：

     Docker version 24.0.5, build 23e70a8docker-compose version 2.20.2

📦 步骤 1：拉取 Attu 镜像

# 拉取 Attu 镜像（推荐使用最新稳定版本）docker pull zilliz/attu:v2.3.8

• 版本说明：

  • 如果需要其他版本，可参考 Attu GitHub Releases。

  • 示例版本 v2.3.8 是当前推荐版本，兼容 Milvus 2.x。

🐳 步骤 2：运行 Attu 容器

# 运行 Attu 容器docker run -d \\  --name attu \\  -p 18000:3000 \\  -e MILVUS_URL=host.docker.internal:19530 \\  --add-host=host.docker.internal:host-gateway \\ zilliz/attu:v2.3.8

• 参数说明：

  • -d：后台运行容器。

  • --name attu：为容器命名为 attu。

  • -p 18000:3000：将容器的 3000 端口映射到主机的 18000 端口（可通过浏览器访问 http://localhost:18000）。

  • -e MILVUS_URL=host.docker.internal:19530：指定 Milvus 的地址和端口（假设 Milvus 已在本地运行）。

  • --add-host=host.docker.internal:host-gateway：解决 Windows/Linux 上的网络问题，确保容器能访问主机服务。

🧪 步骤 3：验证容器运行状态

# 查看容器状态docker ps

• 输出示例：

  CONTAINER ID   IMAGE                 COMMAND         CREATED       STATUS       PORTS                   NAMESabc123456789   zilliz/attu:v2.3.8   \"node app.js\"   5 minutes ago Up 5 minutes 0.0.0.0:18000->3000/tcp attu

🌐 步骤 4：访问 Attu Web 界面

1. 打开浏览器，访问：

   http://localhost:18000

2. 登录信息：

   • 用户名：root

   • 密码：Milvus

⚙️ 步骤 5：连接 Milvus 实例

1. 在 Attu 界面中，点击 \"Connect\" 按钮。

2. 输入 Milvus 的地址和端口（默认 localhost:19530）。

3. 点击 \"Connect\"，即可通过图形化界面管理 Milvus。

🛠️ 常见问题与解决方案

1. Attu 无法访问 Milvus？

• 原因：网络配置错误。

• 解决方法：

  • 确保 Milvus 已正常运行（通过 docker ps 或 docker logs 检查）。

  • 检查 MILVUS_URL 是否正确（需与 Milvus 的地址和端口一致）。

  • Windows 用户需确保 host.docker.internal 能解析到主机 IP。

2. 端口冲突？

• 原因：主机的 18000 端口被占用。

• 解决方法：

  # 修改映射端口docker run -d \\  --name attu \\  -p 18080:3000 \\  # 将 18080 替换为可用端口  -e MILVUS_URL=host.docker.internal:19530 \\  --add-host=host.docker.internal:host-gateway \\ zilliz/attu:v2.3.8

3. 容器启动失败？

• 原因：镜像拉取失败或配置错误。

• 解决方法：

  # 查看容器日志docker logs attu

🧹 停止和删除容器

# 停止容器docker stop attu​# 删除容器docker rm attu

📌 附录：Docker 命令速查表

📚 参考链接

1. Attu GitHub 项目

2. Milvus 官方文档

3. Docker 官方文档