Milvus CLI 是向量数据库 Milvus 版提供的命令行工具，支持控制面和数据面的资源管理与运维操作。通过 Milvus CLI，您可以执行实例管理、网络配置、数据库管理、Collection 管理、索引管理、向量检索以及用户权限管理等操作，帮助您快速完成资源配置和数据管理任务。

支持平台

操作系统	支持架构	安装包格式
Linux	amd64、arm64	tar.gz
macOS	amd64、arm64	tar.gz
Windows	amd64、arm64	zip

安装 CLI

Milvus CLI 支持 Linux、macOS 和 Windows 操作系统，可通过安装脚本、npm 或手动下载二进制文件等方式完成安装。

使用安装脚本安装

Linux/macOS

Windows

执行以下命令安装。

安装完成后，根据终端提示将 CLI 所在目录加入系统环境变量。

使用 npm 安装

执行以下命令安装。

手动下载安装

前往 GitHub Releases 页面下载对应操作系统和架构的预编译二进制文件。下载完成后，解压安装包，并将 milvus-cli 可执行文件添加至系统 PATH 环境变量。

验证安装

安装完成后，可执行以下命令验证是否安装成功。

或

成功返回版本信息或帮助信息即表示安装成功。

快速上手

创建 Profile

执行以下命令创建 CLI 运行环境配置。

milvus-cli profile create \
--name default \
--site volcengine \
--region cn-beijing \
--project default \
--credential volcengine \
--language CN

完成身份认证。

执行以下命令使用火山引擎账号的 Access Key（AK）和 Secret Key（SK）登录。AK 和 SK 的获取方式请参见 Access Key（密钥）管理。

milvus-cli auth login --name volcengine --ak <AK> --sk <SK>

管理实例。

执行以下命令查看实例列表。

milvus-cli instance list

执行以下命令查看实例详情列表。

milvus-cli instance describe --instance-id <instance-id>

创建数据面连接。

执行以下命令创建与 Milvus 实例的数据连接。

milvus-cli data connection create \
--from-instance <instance-id> \
--password <milvus-password>

执行数据操作。

执行以下命令查看数据库列表。

milvus-cli data database list

执行以下命令查看 Collection 列表。

milvus-cli data collection list

执行以下命令执行向量检索。

milvus-cli data vector search \
--collection <collection-name> \
--vector '[1.0, 2.0, 3.0]' \
--limit 10

CLI 命令

Milvus CLI 提供以下命令组。更多信息，请参见命令总览。

命令组	说明	参考文档
auth	登录、登出、查看鉴权状态	control/auth.md
profile	管理 site/region/project/language 上下文	control/profile.md
spec	查看版本、地域、规格、价格、VPC/子网/EIP 信息	control/spec.md
instance	管理 Dedicated 实例	control/instance.md
network	管理 Dedicated endpoint 发布与白名单	control/network.md
version	查看 CLI 构建信息	control/version.md
completion	生成 shell 自动补全脚本	control/completion.md
data connection	管理数据面连接配置	data/connection.md
data database	管理数据库	data/database.md
data collection	管理集合	data/collection.md
data partition	管理分区	data/partition.md
data alias	管理别名	data/alias.md
data index	管理索引	data/index.md
data vector	向量搜索与操作	data/vector.md
data user	管理用户	data/user.md
data role	管理角色	data/role.md
serverless instance	管理 Serverless 实例	serverless/instance.md
serverless network	管理 Serverless 网络配置	serverless/network.md

Agent 集成

Milvus CLI 提供 Agent Skills 技能包，可与 AI 编码助手集成使用，包括：

TRAE

Claude Code

Cursor

Codex

OpenCode

GitHub Copilot

通过集成 Agent Skills，AI 助手可直接调用 Milvus CLI 完成实例管理和数据操作任务。各 Agent 的安装方式请参见 milvus-cli Agent Skill。