华为NPU卡Ubuntu18.04离线安装全攻略：从依赖包下载到驱动配置（避坑指南）

在企业级AI计算环境中，华为Atlas 300 NPU卡凭借其强大的推理能力成为许多项目的首选硬件。但当服务器处于严格的内网隔离环境时，标准的在线安装流程往往寸步难行。本文将分享一套经过金融、医疗等行业验证的全离线安装方案，涵盖从依赖包获取到权限配置的完整闭环。

1. 离线环境准备：构建完整依赖链

1.1 关键依赖包清单

在无网络环境中，需要预先准备以下核心组件（以Ubuntu 18.04 amd64为例）：

# 基础编译工具链
gcc-7_7.5.0-3ubuntu1~18.04_amd64.deb
make_4.1-9.1ubuntu1_amd64.deb
binutils_2.30-21ubuntu1~18.04.4_amd64.deb

# 运行时依赖
libc6-dev_2.27-3ubuntu1.6_amd64.deb
linux-libc-dev_4.15.0-202.232_amd64.deb

提示：使用apt-rdepends工具在有网络环境中生成完整依赖树：
apt-rdepends gcc make binutils | grep -v "^ "

1.2 离线资源获取路径

通过以下渠道获取可信赖的.deb包：

来源	适用场景	示例命令
官方镜像站	基础系统包	wget http://archive.ubuntu.com/ubuntu/pool/main/g/gcc-7/
Launchpad PPA	新版工具链	ppa:ubuntu-toolchain-r/test
华为昇腾社区	NPU专用依赖	需企业账号下载

典型目录结构建议：

~/offline_install/
├── debs/
│   ├── gcc/
│   ├── make/
│   └── libs/
└── npu/
    ├── A300-3010-npu-driver_20.2.0.run
    └── firmware_1.76.22.3.run

2. 依赖包安装：解决连环依赖问题

2.1 批量安装技巧

进入包含所有.deb文件的目录后执行：

# 按依赖顺序强制安装（忽略推荐包）
sudo dpkg --force-all -i *.deb 2>&1 | grep -v "warning"

# 修复未满足的依赖
sudo apt-get -f install --allow-unauthenticated -o Dir::Cache::archives="./"

遇到版本冲突时的解决方案：

# 查看冲突文件
dpkg -l | grep ^rc

# 清除残留配置
sudo dpkg --purge <package-name>

2.2 常见报错处理

当出现gcc: command not found但已安装时：

# 检查环境变量
echo $PATH

# 手动链接（gcc-7为例）
sudo ln -s /usr/bin/gcc-7 /usr/bin/gcc

3. NPU驱动安装：权限与配置详解

3.1 非默认用户安装

当系统没有HwHiAiUser时的解决方案：

# 指定现有用户安装
chmod +x A300-3010-npu-driver_20.2.0.run
sudo ./A300-3010-npu-driver_20.2.0.run \
    --install-username=$(whoami) \
    --install-usergroup=$(id -gn) \
    --full

注意：必须添加--full参数才能启用离线模式

3.2 安装过程监控

实时查看安装日志：

tail -f /var/log/ascend_seclog/ascend_install.log

# 关键成功标志
grep "Install driver success" /var/log/ascend_seclog/operation.log

4. 验证与故障排除

4.1 基础功能测试

安装完成后执行：

# 查看NPU状态
npu-smi info

# 测试计算单元
cd /usr/local/Ascend/driver/tools/
./npu_health_check

4.2 典型问题处理表

现象	根本原因	解决方案
DKMS编译失败	内核头文件缺失	安装linux-headers-$(uname -r)
PCI设备未识别	BIOS设置禁用	启用Above 4G Decoding
虚拟机异常关机	PCI透传冲突	改用裸机部署
npu-smi无输出	驱动未加载	sudo modprobe hisi_hdc

5. 企业级部署建议

对于大规模集群部署，推荐采用以下优化流程：

1. 制作本地仓库镜像
   使用apt-mirror构建内网APT源，包含所有依赖包

2. 自动化安装脚本

   #!/bin/bash
   DEBIAN_FRONTEND=noninteractive \
   sudo dpkg -i /opt/offline/*.deb && \
   ./npu-driver.run --silent \
       --install-username=admin \
       --install-usergroup=admin
   

3. 硬件兼容性检查
   在BIOS中确认：

   • SR-IOV已启用
   • MMIO空间≥64GB
   • 禁用Power Management

实际项目中曾遇到某医疗影像系统因缺省libstdc++6版本导致推理失败，最终通过以下命令解决：

# 强制降级关键库
sudo dpkg -i --force-downgrade libstdc++6_8-20200411-1ubuntu1~18.04_amd64.deb

掌握这些技巧后，即使在严格隔离的生产环境中，也能高效完成NPU集群的部署。建议将关键组件打包成Docker镜像，便于快速迁移和版本控制。