Windows10执行docker pull拉取镜像时提取大文件报unauthorized如何解决

解决方案 #

• 第一步：清理本地失效的缓存与残留分层
  关闭所有运行中的Docker容器后，依次执行以下命令清除拉取失败的残留文件，避免复用损坏分层：

  docker rmi jimiucb1/i526-aml -f
  docker system prune -f
  

• 第二步：校验存储配置与空间余量
  新版Windows Docker Desktop已将原Shared选项迁移至设置->Resources->File Sharing路径，检查你存放Docker数据的磁盘分区已被勾选允许共享。
  执行docker info查看Docker存储目录的剩余空间，需预留至少镜像总大小2倍以上的临时存储空间（建议预留5G以上）。如果使用WSL2作为Docker后端，可额外在PowerShell执行wsl --list -v确认Docker Desktop对应的发行版处于正常运行状态。
• 第三步：单线程拉取镜像
  大镜像多并发拉取容易触发传输中断，进而被误识别为权限异常，执行以下命令禁用并发下载，单线程拉取镜像：
  docker pull --max-concurrent-downloads 1 jimiucb1/i526-aml
• 第四步：排查安全软件拦截
  Windows Defender或第三方杀毒软件会拦截大文件向Docker虚拟存储目录的写入操作，触发unauthorized误报。可临时关闭安全软件的实时保护后重试拉取，拉取完成后恢复保护即可，也可将Docker的存储目录加入安全软件白名单。

内容的提问来源于stack exchange，提问作者Javier Salazar