首页/云/Docker 容器速查/docker run --gpus 使用 GPU
本包目录(366 条)
基础命令50 条
镜像与构建107 条网络与存储52 条Compose 编排55 条资源与安全50 条容器排障52 条

docker run --gpus 使用 GPU

把宿主 NVIDIA GPU 暴露给容器:--gpus all 用全部卡、--gpus 1 用一张;前提是宿主装好驱动与容器工具包。

Docker 容器速查云更新于 2026-10-12
用途为容器挂载 GPU 设备
语法--gpus all / --gpus 1 / --gpus '"device=0,2"'(设备列表写法)
前置NVIDIA 驱动 + nvidia-container-toolkit

示例

示例
docker run --rm --gpus all nvidia/cuda:12.4.0-base-ubuntu22.04 nvidia-smi
docker run --rm --gpus 1 python:3.12-slim nvidia-smi || true
该参数依赖 NVIDIA 容器运行时;Windows 环境经 WSL2 后端支持,纯 CPU 机器上会报错。

易错点

  • 容器内 nvidia-smi 报错先确认宿主驱动版本与 nvidia-container-toolkit 是否安装并重启过 docker
  • 多卡机器上用设备编号前先核对 nvidia-smi 的序数,编号错位会占错卡

数据来源与参考

  • Docker 官方文档:GPU 支持(docs.docker.com/config/containers/resource_constraints)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌