---
title: milvus
description: 昇腾社区是基于昇腾系列处理器和基础软件构建的全栈 AI计算基础设施、行业应用及服务，包括昇腾系列处理器、系列硬件、CANN异构计算架构、AI计算框架、应用使能、开发工具链、管理运维工具、行业应用及服务等全产业链。
keywords: 公开,概述,配套软件版本,使用前提,依赖安装,驱动与固件,如何使用镜像,镜像下载
url: https://www.hiascend.com/developer/ascendhub/detail/milvus
section: (其他)
---

# milvus

URL: https://www.hiascend.com/developer/ascendhub/detail/milvus
描述: 昇腾社区是基于昇腾系列处理器和基础软件构建的全栈 AI计算基础设施、行业应用及服务，包括昇腾系列处理器、系列硬件、CANN异构计算架构、AI计算框架、应用使能、开发工具链、管理运维工具、行业应用及服务等全产业链。
关键词: 公开,概述,配套软件版本,使用前提,依赖安装,驱动与固件,如何使用镜像,镜像下载

昇腾镜像仓库 [了解详情](https://www.hiascend.com/developer/ascendhub)

milvus

## milvus公开

最新版本：v2.5.19-ascend-arm2026/01/04更新大小：7 GB发布者：Ascend108次下载

其他

镜像概述

镜像下载

镜像概述

镜像下载


# 概述

该镜像具备运行index SDK和运行milvus服务所需的基础环境，可方便用户快速上手进行milvus服务搭建，该镜像默认以root用户运行。

# 配套软件版本：

| 镜像版本 | CANN版本 | Index SDK | HDK版本 | 支持的推理芯片 | 架构 |
| --- | --- | --- | --- | --- | ---|
| v2.5.19-ascend | 8.3.RC2 | 7.2.RC1 | 24.1.rc2.3 | Atlas 300I Duo | aarch64 |

# 使用前提

- 物理机已安装Docker
- 物理机上有配套Ascend NPU芯片
- 如果容器以普通用户运行HwHiAiUser物理机上安装驱动时需添加--install-for-all选项

# 依赖安装

## 驱动与固件

Atlas 800I A2推理产品：请参见《Atlas A2 中心推理和训练硬件 24.1.RC3 NPU驱动和固件安装指南 04》中的“物理机安装与卸载 [了解详情](https://support.huawei.com/enterprise/zh/doc/EDOC1100422574/b1977c97?idPath=23710424%7C251366513%7C254884019%7C261408772%7C252764743)”章节。

Atlas 800I A3推理产品：请参见《Atlas A3 中心推理和训练硬件 24.1.RC3 NPU驱动和固件安装指南 05》中的“物理机安装与卸载 [了解详情](https://support.huawei.com/enterprise/zh/doc/EDOC1100430867/906e964a?idPath=23710424%7C251366513%7C254884019%7C261408772%7C252764743)”章节。

Ascend 310p 推理产品：请参见《Atlas 300I 推理卡 24.1.RC2 NPU驱动和固件安装指南（型号 3010）06》中的“物理机安装与卸载 [了解详情](https://support.huawei.com/enterprise/zh/doc/EDOC1100388848/b1977c97?idPath=23710424%7C251366513%7C254884019%7C261408772%7C252764743)”章节。

# 如何使用镜像

## 镜像下载

1. 点击镜像版本
2. 点击镜像版本立即下载

## 准备milvus运行环境

## 运行容器

【方式一】：Ascend Docker Runtime 启动
如果尚未安装 Ascend Docker Runtime，请先获取安装包 [了解详情](https://gitee.com/ascend/mind-cluster/releases)，并参考Ascend Docker Runtime安装部署 [了解详情](https://www.hiascend.com/document/detail/zh/mindx-dl/600/clusterscheduling/clusterschedulingig/clusterschedulingig/dlug_installation_017.html)指南完成安装。

```
docker run -u <user> -e ASCEND_VISIBLE_DEVICES=0 -itd --name=milvus-standalone-ascend --network=milvus \
   -v /usr/local/Ascend/driver:/usr/local/Ascend/driver \
   -v /etc/ascend_install.info:/etc/ascend_install.info \
   -v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi \
   --publish=0.0.0.0:19666:19666 \
   <镜像名称>:<镜像tag>
```

【方式二】：手动挂载设备启动
在启动容器时，通过手动挂载设备的方式将昇腾处理器与容器绑定。

- 设备挂载 ：通过 --device 参数将宿主机的设备文件映射到容器中，确保容器能够访问指定的硬件资源。/dev/davinci为NPU加速卡（按需挂载），/dev/davinci_manager, /dev/hisi_hdc, /dev/devmm_svm为NPU管理设备（全部挂载）。
- 驱动与工具链挂载 ：将宿主机上的驱动文件和工具链目录（如 /usr/local/Ascend/driver 和 /usr/local/sbin）以只读方式挂载到容器中，保证容器内的运行环境与宿主机一致。 以下样例代码中，/dev/davinci0 表示挂载 0 号设备。

```
 docker run -u <user> -itd --name=milvus-standalone-ascend --network=milvus \
  --device=/dev/davinci_manager \
  --device=/dev/hisi_hdc \
  --device=/dev/devmm_svm \
  --device=/dev/davinci0 \
  -v /usr/local/Ascend/driver:/usr/local/Ascend/driver \
  -v /etc/ascend_install.info:/etc/ascend_install.info \
  -v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi \
  --publish=0.0.0.0:19666:19666 \
  <镜像名称>:<镜像tag>
```

关键参数解释：

- `user`: 容器运行用户，可配置为root或HwHiAiUser，如果不配置默认使用root,建议以普通用户HwHiAiUser运行降低容器运行相关安全风险
- `<镜像名称>:<镜像tag>`：从ascendhub网上拉取镜像后的镜像ID, 可通过以下命令查询获取

```
 docker images |grep milvus
```

1. 启动etcd、minio服务

```
# 首先下载配置文件:
wget https://github.com/milvus-io/milvus/releases/download/v2.5.19/milvus-standalone-docker-compose.yml -O docker-compose.yml
# 由于一会要手动启动 milvus，在这里先删除 docker-compose.yml 文件中 milvus-standalone 的相关部分，然后执行:
docker-compose up -d
```
2. 进入容器

```
docker exec -it milvus-standalone-ascend bash
```
3. 执行npu-smi info命令检查驱动是否挂载正常
4. 在容器里面的/home/milvus/目录下，设置环境变量

```
cd /home/milvus
source env.sh
```
5. 在容器里面的/home/milvus/config/milvus.yaml，对milvus进行配置

```
etcd:
 endpoints: milvus-etcd:2379  # 根据docker-compose.yml中etcd服务名进行修改

minio:
   address: milvus-minio      # 根据docker-compose.yml中minio服务名进行修改
   port: 9000

proxy:
   port: 19666                # 启动容器时映射的端口
```
6. 参考此文档 [了解详情](https://www.hiascend.com/document/detail/zh/mindsdk/72rc1/indexn/indexug/mxindexfrug_0014.html)生成并配置算子路径后，启动 milvus 服务

```
cd /home/milvus
./bin/milvus run standalone
```

## 错误处理

若镜像中生成算子时报错：PATH is invalid when executing the cmd python3-config --prefix.

```
ln -s /usr/local/python3.11.13/bin/python3.11-config /usr/local/python3.11.13/bin/python3-config
```

# 变更说明

- 2025/12/17：首次镜像更新。

milvus 镜像版本

| 版本 | 文件大小 | 更新时间 | 架构 | 操作 |
| --- | --- | --- | --- | ---|
| v2.5.19-ascend-arm | 7 GB | 2026/01/04 | arm64 | 立即下载 |