Docker Desktop配置国内镜像源教程

优雅的造轮狮

于 2025-03-15 18:15:00 发布

阅读量1.1w

点赞数 45

分类专栏： Docker学习笔记磨刀不误砍柴工文章标签： docker 容器运维

本文链接：https://blog.csdn.net/qq_23311271/article/details/146259874

版权

Docker学习笔记同时被 2 个专栏收录

2 篇文章

订阅专栏

磨刀不误砍柴工

2 篇文章

订阅专栏

在使用 Docker 时，由于默认镜像源在国外，经常会遇到下载速度慢、连接超时等问题。本文将详细介绍如何在 Windows 系统中为 Docker 配置国内镜像源，以提升镜像拉取速度。

常用国内镜像源

https://docker.1ms.run

清华镜像源

https://docker.mirrors.tuna.tsinghua.edu.cn

阿里云镜像源

https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

网易镜像源

http://hub-mirror.c.163.com

中科大镜像源

https://mirrors.ustc.edu.cn/docker-ce/linux/centos/docker-ce.repo

腾讯云镜像源

https://mirror.ccs.tencentyun.com

配置步骤

方法一：通过Docker Desktop配置

打开Docker Desktop
点击右上角的设置图标（⚙️）
选择左侧菜单中的「Docker Engine」
在右侧JSON配置中添加或修改registry-mirrors字段：
在这里插入图片描述

{
  "registry-mirrors": [
    "https://hub-mirror.c.163.com",
    "https://mirror.ccs.tencentyun.com",
    "https://mirrors.aliyun.com"
  ]
}

在这里插入图片描述

点击「Apply & Restart」应用配置并重启 Docker

方法二：直接修改配置文件

打开配置文件

# 配置文件位置
%USERPROFILE%\.docker\daemon.json

win + r 打开 %USERPROFILE%

在这里插入图片描述

如果文件不存在，创建新文件并添加以下内容：

{
  "registry-mirrors": [
    "https://hub-mirror.c.163.com",
    "https://mirror.ccs.tencentyun.com",
    "https://mirrors.aliyun.com"
  ]
}

保存文件后重启Docker Desktop
在这里插入图片描述

验证配置

打开 PowerShell，运行以下命令查看当前配置：

docker info

在输出信息中查找Registry Mirrors部分，确认配置的镜像源已生效
在这里插入图片描述

使用阿里云镜像加速器

配置镜像加速器_容器镜像服务 (ACR) 阿里云帮助中心
在这里插入图片描述

登录阿里云控制台

搜索「容器镜像服务」
在左侧菜单选择「镜像工具」->「镜像加速器」
获取专属加速器地址
将地址添加到registry-mirrors配置中

在这里插入图片描述

同上其他方法配置重启即可

定期清理本地缓存

# 清理未使用的镜像
docker image prune -a

# 清理未使用的数据卷
docker volume prune

# 清理构建缓存
docker builder prune

合理使用镜像标签
使用具体版本号而不是latest标签及时更新过时的镜像

常见问题解决

配置不生效

检查配置文件格式是否正确
确保Docker Desktop完全重启
检查系统防火墙设置

镜像源连接失败

尝试更换其他镜像源
检查网络连接
验证镜像源地址是否有效

参考资料

Docker 官方文档
 阿里云镜像服务
 Docker/DockerHub 国内镜像源 / 加速列表（3 月 12 日更新长期维护）腾讯云开发者社区腾讯云