Windows11上Docker Desktop镜像源配置失效排查与解决方案

Windows11上Docker Desktop镜像源配置失效排查与解决

适用场景：已配置镜像源但 docker pull 仍从官方源拉取， docker info 显示正常但实际未生效

1、如果2、3解决方案均未奏效

终极方案

命令行临时指定镜像源： 

docker pull docker.1panel.dev/library/镜像名

默认拉取最新版

示例： 

docker pull docker.1ms.run/library/nginx

注意：

• 部分镜像源需在地址中插入 library 层级（如1Panel镜像源），具体在对应镜像网站查看。
• 使用前需验证镜像源是否支持目标镜像（如访问镜像源官网）

2、残留代理配置导致冲突

问题根源：

Docker Desktop历史代理配置未清除，导致镜像源被代理覆盖。

解决方案：

关闭Docker Desktop代理：

打开Docker Desktop → Settings → Resources → Proxies → 取消所有代理配置。

清空残留代理文件：

定位到 %AppData%/Roaming/Docker/http_proxy.json ，删除或清空其中 http 和 https 字段内容。

重启Docker服务（需完全退出Docker Desktop后重新启动）。

3、Docker缓存未清理

问题根源：

缓存中残留历史镜像元数据，导致Docker优先使用旧配置。

解决方案：

清理Docker系统缓存：

docker system prune -a

重启Docker服务：

net stop com.docker.service

net start com.docker.service

总结

以上为个人经验，希望能给大家一个参考。