关于Docker【常见问题解决方案】

1、Docker Desktop

【1】Docker Desktop启动时报错

问题描述
可能原因
这是 Docker Desktop 在首次初始化 WSL2 后端时最常见的报错。
根本原因：WSL2 没装好 / 版本太旧 / 注册表残留。
解决方案
🔧 步骤 1：关掉 Docker Desktop
右下角鲸鱼图标 → Quit Docker Desktop（完全退出）。
🔧 步骤 2：重置 WSL2 环境
以 管理员身份 打开 PowerShell，逐行执行：
1、注销 Docker 相关的所有 WSL 发行版

wsl --unregister docker-desktop
wsl --unregister docker-desktop-data

2、确保系统已启用 WSL2 并更新到最新内核

wsl --update
wsl --shutdown

执行完毕后，重启电脑。
🔧 步骤 3：重新安装 / 修复 WSL2
再次打开 管理员 PowerShell，执行：powershell
如果提示 “WSL2 内核需要更新”，直接运行：wsl --update
确保默认版本是 2 wsl --set-default-version 2
🔧 步骤 4：重新启动 Docker Desktop
1、双击桌面 Docker Desktop 图标。
2、第一次启动会重新部署 WSL2 发行版，耐心等待 1-3 分钟。
3、出现提示 “Docker Desktop is running” 即成功。
🔧 步骤 5：验证 WSL2 已正常
在 PowerShell 中输入：wsl -l -v
应看到类似输出（ STATE 均为 Running ）：
NAME STATE VERSION
*docker-desktop Running 2
docker-desktop-data Running 2

【2】docker run报错

问题描述
执行以下命令：

docker run --rm --gpus all nvidia/cuda:12.1.0-runtime-ubuntu22.04 nvidia-smi

报错信息如下：

Unable to find image 'nvidia/cuda:12.1.0-runtime-ubuntu22.04' locally
docker: Error response from daemon: Get "https://registry-1.docker.io/v2/": EOF.
See 'docker run --help'.

可能原因
Docker 无法连接官方镜像仓库（registry-1.docker.io），拉取镜像失败。
解决方案
[1] 配置国内镜像加速器
1、打开 Docker Desktop → Settings → Docker Engine
2、添加如下配置：
{
“registry-mirrors”: [
“https://docker.m.daocloud.io”,
“https://dockerproxy.com”,
“https://registry.docker-cn.com”
]
}
也可添加阿里云镜像加速器地址，网址如下https://cr.console.aliyun.com/cn-hangzhou/instances/mirrors

2、镜像

【1】docker pull一直卡住

问题描述

解决方案
[1] 多尝试几次