Docker Desktop配置国内镜像源教程

发布于:2025-03-19 ⋅ 阅读:(14) ⋅ 点赞:(0)

在使用 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 日更新 长期维护)腾讯云开发者社区 腾讯云


网站公告

今日签到

点亮在社区的每一天
去签到