一、準備工作

1.1 環境要求

• 操作系統：Ubuntu 20.04/Debian 11/CentOS 7+
• 硬件配置：至少8GB內存，4核CPU，50GB磁盤空間
• 網絡要求：可訪問互聯網（用于拉取Docker鏡像）

1.2 安裝Docker和Docker Compose

1.2.1 安裝Docker

sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker

1.2.2 驗證Docker安裝

docker --version
sudo docker run hello-world

1.2.3 安裝Docker Compose

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

1.2.4 驗證Docker Compose安裝

docker-compose --version

二、部署Milvus數據庫

2.1 創建部署目錄

mkdir -p /opt/milvus
cd /opt/milvus

2.2 下載官方Docker Compose配置文件

wget https://github.com/milvus-io/milvus/releases/download/v2.5.10/milvus-standalone-docker-compose.yml -O docker-compose.yml

2.3 啟動Milvus服務

sudo docker-compose up -d

2.4 驗證Milvus服務狀態

sudo docker-compose ps

正常輸出應顯示三個容器（milvus-etcd、milvus-minio、milvus-standalone）均為"Up"狀態

2.5 查看Milvus日志

sudo docker-compose logs -f milvus-standalone

2.6 測試Milvus端口連通性

nc -zv localhost 19530

三、部署Attu可視化管理工具

3.1 使用Docker啟動Attu

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

3.2 驗證Attu容器狀態

docker ps | grep attu

四、訪問與使用

4.1 訪問Attu管理界面

打開瀏覽器訪問：

http://服務器IP:8000

4.2 連接Milvus數據庫

• 在登錄頁面輸入Milvus服務地址：http://服務器IP:19530
• 點擊"連接"按鈕（默認無需用戶名密碼）

4.3 基本操作指南

1. 創建數據庫：點擊"創建數據庫"，輸入名稱即可
2. 創建集合：設置集合名稱、向量維度和索引類型
3. 導入數據：支持JSON/CSV文件批量導入
4. 向量搜索：輸入查詢向量，設置搜索參數執行相似性搜索

五、常用操作命令

5.1 停止Milvus服務

cd /opt/milvus sudo docker-compose down

5.2 啟動Milvus服務

cd /opt/milvus sudo docker-compose up -d

5.3 重啟Attu服務

docker restart milvus-attu

5.4 查看Milvus數據目錄

ls -la /opt/milvus/volumes

六、注意事項

6.1 版本兼容性

• Attu版本需與Milvus版本匹配，例如Attu v2.5對應Milvus 2.5.x
• 查看Milvus版本：docker images | grep milvusdb/milvus

6.2 國內鏡像源配置

若拉取鏡像緩慢，可配置Docker國內鏡像源：

sudo tee /etc/docker/daemon.json <<-'EOF'
{"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

6.3 防火墻設置

開放必要端口：

sudo ufw allow 19530/tcp
sudo ufw allow 8000/tcp
sudo ufw reload

6.4 數據備份

定期備份Milvus數據目錄：

cp -r /opt/milvus/volumes /opt/milvus/volumes_backup_$(date +%Y%m%d)

七、問題排查

7.1 Milvus啟動失敗

檢查系統資源是否充足：

free -h df -h

7.2 Attu無法連接Milvus

檢查網絡連通性：

telnet 服務器IP 19530

7.3 查看詳細日志

sudo docker-compose logs --tail=100 milvus-standalone 
docker logs milvus-attu

八、總結

通過Docker Compose方式部署Milvus和Attu是最簡單高效的方法，適合開發測試和中小型生產環境。本文詳細介紹了從環境準備到服務部署的完整流程，包括常用操作命令和問題排查方法。如有進一步需求，可參考Milvus官方文檔進行分布式部署或高級配置。