华为昇腾910B保姆级环境配置指南：从驱动安装到Docker容器实战

华为昇腾910B保姆级环境配置指南：从驱动安装到Docker容器实战

最近在几个AI推理和训练项目里，我深度用上了华为的昇腾910B。说实话，从熟悉的CUDA生态切换过来，初期确实踩了不少坑。网上的资料要么过于零散，要么版本陈旧，照着做十有八九会卡在某个环节。这篇文章，就是把我从零开始，在一台全新的Atlas 800服务器上，成功搭建起一套稳定、可用的昇腾910B开发环境的完整过程记录下来。它不仅仅是一份命令清单，更侧重于解释每个步骤背后的“为什么”，以及遇到那些令人头疼的报错时，我是如何排查和解决的。无论你是刚开始接触昇腾平台的算法工程师，还是负责底层部署的运维同学，希望这份融合了实战经验和避坑指南的内容，能让你少走弯路，快速把环境跑起来。

1. 启程：理解你的昇腾硬件与基础环境

在开始敲任何命令之前，花几分钟理解你手头的硬件和基础系统，能避免后续很多方向性错误。昇腾910B通常搭载在华为的Atlas 800训练服务器上，这是一台基于ARM架构（aarch64）的大家伙，其操作系统通常是定制的EulerOS或OpenEuler，这与我们常见的x86 CentOS/Ubuntu有些许差异。

首先，我们得确认NPU（神经网络处理单元）是否被系统正确识别。这就像给新电脑装显卡驱动前，先要确保显卡已经插好一样。

# 1. 使用lspci命令查看硬件设备列表，筛选出昇腾设备
lspci | grep -i d801

# 预期你会看到类似这样的输出，数量对应你服务器中的NPU卡数（例如8卡）：
# 0000:89:00.0 Processing accelerators: Huawei Technologies Co., Ltd. Device d801
# 0000:8a:00.0 Processing accelerators: Huawei Technologies Co., Ltd. Device d801

如果这条命令没有输出，那意味着硬件可能未上电、未插稳，或者需要在BIOS中启用相关选项，这是需要联系硬件管理员首先排查的层面。

接下来，使用昇腾平台提供的专属管理工具 npu-smi，它的角色类似于NVIDIA的 nvidia-smi。

# 2. 查看所有NPU的概要信息
npu-smi info

# 3. 查看指定卡（例如0号卡）的详细利用率、温度、功耗等
npu-smi info -t usages -i 0

一个健康的输出应该清晰显示芯片型号（如910ProB）、固件版本、算力利用率、温度（通常应低于90°C）和功耗信息。如果执行 npu-smi 报错“command not found”，那说明驱动没有安装，我们将从这一步开始。如果它能正常运行，恭喜你，最底层的基础已经打好。

注意：npu-smi 工具依赖于驱动层的正确安装。有时即使驱动装了，如果服务未启动，也会报错。可以尝试 systemctl status ascend-dmi 查看相关服务状态。

最后，确认一下系统架构和版本，这关系到后续所有软件包的选择。

# 4. 查看系统架构和发行版信息
uname -m && cat /etc/os-release

你一定会看到 aarch64 和 EulerOS 或 OpenEuler 的字样。记住这个 aarch64，它意味着所有后续安装的软件（如Conda、PyTorch轮子）都必须是对应ARM版本的，直接使用x86的安装包会导致无法执行。

2. 基石：驱动、固件与CANN的安装与验证

驱动和固件是硬件能够被操作系统调用的桥梁，而CANN（Compute Architecture for Neural Networks）则是昇腾的异构计算架构，相当于CUDA在NVIDIA生态中的核心地位。这三者的版本必须严格配套，通常华为会提供一个完整的软件包组合。

第一步：获取正确的软件包。 前往昇腾社区官网的“驱动与固件”下载专区。选择与你硬件型号（Atlas 800训练服务器/910B）和操作系统（EulerOS 22.03 LTS SP2等）完全匹配的驱动、固件和CANN安装包。版本号是关键，例如“23.0.RC3”系列。

第二步：安装驱动与固件。 假设你已经通过SFTP等方式将下载的 .run 文件上传至服务器的 /opt 目录。

# 进入软件包目录
cd /opt

# 为安装文件添加执行权限
chmod +x Ascend-hdk-910b-npu-driver_23.0.rc3_linux-aarch64.run

# 执行全量安装，--install-for-all 表示给所有用户安装
sudo ./Ascend-hdk-910b-npu-driver_23.0.rc3_linux-aarch64.run --full --install-for-all

安装过程是交互式的，通常会询问安装路径（默认 /usr/local/Ascend）和是否创建用户组。一路确认即可。安装成功后，终端会明确提示 “Driver package installed successfully!”。

固件安装过程类似，使用对应的固件 .run 文件。有时驱动安装包已包含固件，请以官方文档为准。

第三步：安装CANN工具套件。 CANN通常以 .run 文件或 .tar 压缩包形式提供。使用 .run 文件的安装方式与驱动类似。