通过 docker 安装 milvus 向量数据库

通过 Docker 安装 Milvus Standalone（单机版） 是解决 Windows 无法运行 Milvus Lite 以及应对高并发生产场景的标准方案。 [1, 2]
以下使用官方推荐的 Docker Compose 方式进行一键部署（包含核心引擎、分布式协调器 etcd 和存储组件 MinIO）。 [3, 4]

---

一、 快捷安装步骤

请在您的终端（Windows 用户请使用 PowerShell 或 WSL2）中执行以下命令： [5]

1. 创建工作目录

mkdir milvus && cd milvus

2. 下载官方配置文件

根据所需的稳定版，下载对应的 Compose 配置文件： [6]

使用 wget 下载并重命名为 docker-compose.yml

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

提示：如果没有 wget 命令，也可以直接在浏览器中打开该 GitHub 链接 并保存为 docker-compose.yml。 [7]

3. 启动容器集群

在配置文件同级目录下执行后台启动命令：

docker compose up -d

---

二、 验证安装状态

启动后，可以使用以下命令查看运行中的容器群： [4]

docker compose ps

预期输出：
您会看到至少有 3 个容器 处于运行状态（Up / Healthy）： [4]

• milvus-standalone：核心向量数据库引擎，对外暴露 19530 (gRPC 客户端) 和 9091 (Web 管理端口)。
• milvus-etcd：负责元数据管理与协调。
• milvus-minio：负责存储实际的数据块与索引。 [4, 8, 9]

---

三、 客户端代码调整（重点）

由于数据库已切换至 Docker 容器，您在之前代码里使用的本地 .db 文件初始化方式需要修改为 URL 端口连接： [2]

🔹 Python 客户端 (PyMilvus) 修改

from pymilvus import MilvusClient
# 停止使用 client = MilvusClient("./milvus_demo.db")# 替换为连接本地 Docker 端口client = MilvusClient(
	uri="http://localhost:19530",
	token="root:Milvus" # 默认用户名和密码
)

🔹 Java 客户端 (LangChain4j) 修改

EmbeddingStore<TextSegment> embeddingStore = MilvusEmbeddingStore.builder()
		.uri("http://localhost:19530") // 直接指向 Docker 暴露出来的端口
		.collectionName("your_collection")
		.dimension(512)
		.build();

---

四、 可视化后台：图形化管理数据

Milvus 镜像内置了 WebUI，或者您可以选择安装更强大的官方 GUI 工具。

1. 基础监控：直接在浏览器访问 http://localhost:9091/webui/ 查看集群内部节点健康状况。
2. 可视化管理 (Attu)：如果您需要查看集合（Collection）结构、导入数据或进行图形化向量搜索，可以另外下载官方推荐的专属客户端 Attu 工具。 [1, 9]

[1] https://milvus.io
[2] https://github.com
[3] https://whdrns2013.github.io
[4] https://milvus.io
[5] https://milvus.io
[6] https://zilliz.com
[7] https://github.com
[8] https://medium.com
[9] https://milvus.io