Milvus学习总结

一.Milvus概述

• 官网网址：https://milvus.io/
  向量是神经网络模型的一种常用输出形式，用于把文本、图像等信息表示为数值特征。基于向量相似度的检索，常见于知识库检索、语义搜索以及检索增强生成（RAG）等场景。
  Milvus 是开源向量数据库（Apache 2.0），用于向量的存储与相似度检索。
  
• 文档地址： https://milvus.io/docs/zh

二. Docker Compose 安装 Milvus

利用Docker Desktop安装

安装前准备

1. 安装 Docker Desktop

• 1.Docker Desktop 下载并安装

• 2.打开 Docker Desktop，等左下角显示 Docker is running

• 3.在 Settings → Resources 中建议：

  • CPUs：至少 4 核（官方最低 2 核，实际开发建议 4+）
  • Memory：至少 8 GB（向量检索吃内存，数据多可调到 12–16 GB）
  • Disk：预留 20 GB+
    

2. 确认 Docker Compose 可用

在终端执行：

docker--version docker compose version

应看到 Docker 和 Compose V2。

安装步骤

Docker Compose 安装（Standalone）
会启动 3 个容器：

1.创建工作目录并进入：

mkdir-p ~/milvus-2.6.0 cd ~/milvus-2.6.0

2.下载 2.6.0 官方 Compose 文件

Mac 上用 curl：

curl-fL\ https://github.com/milvus-io/milvus/releases/download/v2.6.0/milvus-standalone-docker-compose.yml \-o docker-compose.yml

或者（wget）：

wget https://github.com/milvus-io/milvus/releases/download/v2.6.0/milvus-standalone-docker-compose.yml \-o docker-compose.yml

3.创建 user.yaml（配置安全认证）

cat> user.yaml <<'EOF'common: security: authorizationEnabled: true defaultRootPassword:"YourSecurePass123!"superUsers: root EOF

把 YourSecurePass123! 换成你自己的强密码。

4. 修改 docker-compose.yml，挂载 user.yaml

在 standalone 服务的 volumes 里增加一行：

-./user.yaml:/milvus/configs/user.yaml

user.yaml 会覆盖容器内 milvus.yaml 的同名配置，比挂载整份 milvus.yaml 更简单。

5.Attu 图形管理工具配置

写入 docker-compose.yml

attu: container_name: attu image: zilliz/attu:v2.6.5 environment: MILVUS_URL: milvus-standalone:19530 ports:-"8000:3000"depends_on: standalone: condition: service_healthy

Attu = Milvus 的可视化管理控制台，用来代替大量 Python/命令行操作，更方便地管理集合、查数据、做向量搜索和权限配置。

6.校验配置语法

保存后执行：

docker compose config

无报错即表示 YAML 语法和缩进都正确。

7.首次启动服务

docker compose up-d

首次会拉取镜像（约 1–2 GB），需要几分钟。

8.检查状态

docker composeps

正常应类似：

NAME STATUS milvus-etcd Up milvus-minio Up milvus-standalone Up

健康检查：

curl http://127.0.0.1:9091/healthz

返回 OK 即表示服务正常。

9.访问 WebUI

浏览器打开：

http://127.0.0.1:9091/webui/

可查看集合、节点状态等。

10.Attu 登录：

• 地址：http://127.0.0.1:8000
• 用户名：root
• 密码：你在 user.yaml 里设置的密码

Attu 图形界面：

三.常用管理命令

在 docker-compose.yml 所在目录执行

cd ~/milvus-2.6.0# 检查 compose 语法（校验并打印解析后的配置）docker compose config# 列出服务名docker compose config--services# 查看使用的镜像docker compose images# 拉镜像并启动（后台启动所有服务）docker compose up-d# 只启动某个服务docker compose up-d standalone# 查看服务状态docker composeps# 查看全部日志docker compose logs# 实时跟踪日志docker compose logs-f# 只看 Milvus 日志docker compose logs standalone# 看最近 100 行docker compose logs--tail=100 attu# 查看容器内进程docker compose top# 健康检查curl http://127.0.0.1:9091/healthz# 停止容器（不删除）docker compose stop# 启动已停止的容器docker composestart# 重启所有服务docker compose restart# 重启指定服务docker compose restart standalone# 停止并删除容器docker compose down# 删除所有持久化数据（会丢 collection）rm-rf volumes