重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
ascend-docker by ascend-ai-coding/awesome-ascend-skills
npx skills add https://github.com/ascend-ai-coding/awesome-ascend-skills --skill ascend-docker创建为华为 Ascend NPU 开发配置的 Docker 容器。
# 特权模式(默认,自动检测所有设备)
./scripts/run-ascend-container.sh <image> <container_name>
# 基础模式,指定设备
./scripts/run-ascend-container.sh <image> <container_name> --mode basic
# 完整模式,选择设备
./scripts/run-ascend-container.sh <image> <container_name> --mode full --device-list "0,1,2,3"
脚本会自动从 /dev/davinci* 检测可用的 NPU 设备。使用 --device-list 来选择特定设备:
# 使用所有检测到的设备(默认)
./scripts/run-ascend-container.sh <image> <container_name>
# 使用特定设备
./scripts/run-ascend-container.sh <image> <container_name> --device-list "0,1,2,3"
# 使用设备范围
./scripts/run-ascend-container.sh <image> <container_name> --device-list "0-3"
# 组合范围和单个设备
./scripts/run-ascend-container.sh <image> <container_name> --device-list "0-3,7,10-11"
检查可用设备:
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
ls /dev/davinci* | grep -oE 'davinci[0-9]+$'
拥有最大权限,适用于没有特定要求的情况。
docker run -itd --privileged --name=<CONTAINER_NAME> --ipc=host --net=host \
--device=/dev/davinci_manager \
--device=/dev/devmm_svm \
--device=/dev/hisi_hdc \
-v /usr/local/sbin:/usr/local/sbin:ro \
-v /usr/local/Ascend/driver:/usr/local/Ascend/driver:ro \
-v /home:/home \
-w /home \
<IMAGE> \
/bin/bash
映射特定设备并使用主机网络,适用于推理工作负载。
docker run -itd --net=host \
--name=<CONTAINER_NAME> \
--device=/dev/davinci_manager \
--device=/dev/hisi_hdc \
--device=/dev/devmm_svm \
--device=/dev/davinci0 \
--device=/dev/davinci1 \
... \
-v /usr/local/Ascend/driver:/usr/local/Ascend/driver:ro \
-v /usr/local/sbin:/usr/local/sbin:ro \
-v /etc/localtime:/etc/localtime \
-v /home:/home \
<IMAGE> \
/bin/bash
支持性能分析、日志记录、数据转储和附加组件。
docker run -itd --ipc=host \
--name=<CONTAINER_NAME> \
--device=/dev/davinci_manager \
--device=/dev/devmm_svm \
--device=/dev/hisi_hdc \
--device=/dev/davinci0 \
--device=/dev/davinci1 \
... \
-v /usr/local/Ascend/driver:/usr/local/Ascend/driver \
-v /usr/local/Ascend/add-ons/:/usr/local/Ascend/add-ons/ \
-v /usr/local/sbin/npu-smi:/usr/local/sbin/npu-smi \
-v /usr/local/sbin/:/usr/local/sbin/ \
-v /var/log/npu/conf/slog/slog.conf:/var/log/npu/conf/slog/slog.conf \
-v /var/log/npu/slog/:/var/log/npu/slog \
-v /var/log/npu/profiling/:/var/log/npu/profiling \
-v /var/log/npu/dump/:/var/log/npu/dump \
-v /var/log/npu/:/usr/slog \
-v /etc/localtime:/etc/localtime \
-v /home:/home \
<IMAGE> \
/bin/bash
| 特性 | 特权模式 | 基础模式 | 完整模式 |
|---|---|---|---|
| 网络模式 | host | host | - |
| IPC 模式 | host | - | host |
| 设备访问 | 全部(通过特权) | 选定设备 | 选定设备 |
| 性能分析支持 | ✓ | ✗ | ✓ |
| 数据转储支持 | ✓ | ✗ | ✓ |
| 日志记录(slog) | ✓ | ✗ | ✓ |
| 安全性 | 最低 | 较高 | 较高 |
| 设备 | 用途 |
|---|---|
/dev/davinci_manager | NPU 设备管理器 |
/dev/devmm_svm | 设备内存管理 |
/dev/hisi_hdc | HDC 通信设备 |
/dev/davinci<N> | 单个 NPU 设备(0, 1, 2, ...) |
| 卷 | 用途 |
|---|---|
/usr/local/Ascend/driver | Ascend 驱动库 |
/usr/local/sbin | NPU 管理工具(npu-smi) |
/usr/local/Ascend/add-ons | 附加 Ascend 组件 |
/var/log/npu/slog | 系统日志 |
/var/log/npu/profiling | 性能分析数据 |
/var/log/npu/dump | 数据转储 |
/etc/localtime | 时区同步 |
/home | 用户工作空间 |
ascendhub.huawei.com/public-ascendhub/ascend-pytorch:24.0.RC1
ascendhub.huawei.com/public-ascendhub/ascend-mindspore:24.0.RC1
ascendhub.huawei.com/public-ascendhub/ascend-toolkit:24.0.RC1
docker exec -it <container_name> bash
docker stop <container_name>
docker start <container_name>
docker rm -f <container_name>
对于自构建的镜像,配置环境变量:
echo 'source /usr/local/Ascend/ascend-toolkit/set_env.sh' >> ~/.bashrc
source ~/.bashrc
每周安装量
47
代码仓库
GitHub 星标数
33
首次出现
2026年2月25日
安全审计
安装于
codex47
github-copilot46
kimi-cli46
amp46
gemini-cli46
cursor46
Create Docker containers configured for Huawei Ascend NPU development.
# Privileged mode (default, auto-detect all devices)
./scripts/run-ascend-container.sh <image> <container_name>
# Basic mode with specific devices
./scripts/run-ascend-container.sh <image> <container_name> --mode basic
# Full mode with selected devices
./scripts/run-ascend-container.sh <image> <container_name> --mode full --device-list "0,1,2,3"
The script auto-detects available NPU devices from /dev/davinci*. Use --device-list to select specific devices:
# Use all detected devices (default)
./scripts/run-ascend-container.sh <image> <container_name>
# Use specific devices
./scripts/run-ascend-container.sh <image> <container_name> --device-list "0,1,2,3"
# Use device range
./scripts/run-ascend-container.sh <image> <container_name> --device-list "0-3"
# Combine ranges and individual devices
./scripts/run-ascend-container.sh <image> <container_name> --device-list "0-3,7,10-11"
Check available devices:
ls /dev/davinci* | grep -oE 'davinci[0-9]+$'
Maximum permissions, suitable when no specific requirements.
docker run -itd --privileged --name=<CONTAINER_NAME> --ipc=host --net=host \
--device=/dev/davinci_manager \
--device=/dev/devmm_svm \
--device=/dev/hisi_hdc \
-v /usr/local/sbin:/usr/local/sbin:ro \
-v /usr/local/Ascend/driver:/usr/local/Ascend/driver:ro \
-v /home:/home \
-w /home \
<IMAGE> \
/bin/bash
Specific device mapping with network host, for inference workloads.
docker run -itd --net=host \
--name=<CONTAINER_NAME> \
--device=/dev/davinci_manager \
--device=/dev/hisi_hdc \
--device=/dev/devmm_svm \
--device=/dev/davinci0 \
--device=/dev/davinci1 \
... \
-v /usr/local/Ascend/driver:/usr/local/Ascend/driver:ro \
-v /usr/local/sbin:/usr/local/sbin:ro \
-v /etc/localtime:/etc/localtime \
-v /home:/home \
<IMAGE> \
/bin/bash
With profiling, logging, dump, and add-ons support.
docker run -itd --ipc=host \
--name=<CONTAINER_NAME> \
--device=/dev/davinci_manager \
--device=/dev/devmm_svm \
--device=/dev/hisi_hdc \
--device=/dev/davinci0 \
--device=/dev/davinci1 \
... \
-v /usr/local/Ascend/driver:/usr/local/Ascend/driver \
-v /usr/local/Ascend/add-ons/:/usr/local/Ascend/add-ons/ \
-v /usr/local/sbin/npu-smi:/usr/local/sbin/npu-smi \
-v /usr/local/sbin/:/usr/local/sbin/ \
-v /var/log/npu/conf/slog/slog.conf:/var/log/npu/conf/slog/slog.conf \
-v /var/log/npu/slog/:/var/log/npu/slog \
-v /var/log/npu/profiling/:/var/log/npu/profiling \
-v /var/log/npu/dump/:/var/log/npu/dump \
-v /var/log/npu/:/usr/slog \
-v /etc/localtime:/etc/localtime \
-v /home:/home \
<IMAGE> \
/bin/bash
| Feature | Privileged | Basic | Full |
|---|---|---|---|
| Network mode | host | host | - |
| IPC mode | host | - | host |
| Device access | All (via privileged) | Selected devices | Selected devices |
| Profiling support | ✓ | ✗ | ✓ |
| Dump support | ✓ | ✗ | ✓ |
| Logging (slog) | ✓ | ✗ | ✓ |
| Security | Lowest | Higher | Higher |
| Device | Purpose |
|---|---|
/dev/davinci_manager | NPU device manager |
/dev/devmm_svm | Device memory management |
/dev/hisi_hdc | HDC communication device |
/dev/davinci<N> | Individual NPU devices (0, 1, 2, ...) |
| Volume | Purpose |
|---|---|
/usr/local/Ascend/driver | Ascend driver libraries |
/usr/local/sbin | NPU management tools (npu-smi) |
/usr/local/Ascend/add-ons | Additional Ascend components |
/var/log/npu/slog | System logs |
/var/log/npu/profiling | Profiling data |
/var/log/npu/dump |
ascendhub.huawei.com/public-ascendhub/ascend-pytorch:24.0.RC1
ascendhub.huawei.com/public-ascendhub/ascend-mindspore:24.0.RC1
ascendhub.huawei.com/public-ascendhub/ascend-toolkit:24.0.RC1
docker exec -it <container_name> bash
docker stop <container_name>
docker start <container_name>
docker rm -f <container_name>
For self-built images, configure environment variables:
echo 'source /usr/local/Ascend/ascend-toolkit/set_env.sh' >> ~/.bashrc
source ~/.bashrc
Weekly Installs
47
Repository
GitHub Stars
33
First Seen
Feb 25, 2026
Security Audits
Gen Agent Trust HubFailSocketPassSnykWarn
Installed on
codex47
github-copilot46
kimi-cli46
amp46
gemini-cli46
cursor46
AI界面设计评审工具 - 全面评估UI/UX设计质量、检测AI生成痕迹与优化用户体验
58,500 周安装
| Dump data |
/etc/localtime | Timezone sync |
/home | User workspace |