最新说明:由于不可描述的原因,很多镜像源地址已经失效。
现在可以使用的镜像源地址:
- https://docker-0.unsee.tech/
其他的,可以参考 目前国内可用Docker镜像源汇总(截至2025年3月) - CoderJia
以下是旧文:
在国内使用 Docker Desktop for Windows 时,由于网络原因,从默认的 Docker Hub 下载镜像可能会很慢。本教程将介绍如何配置国内镜像源,以提升镜像的下载速度。
常用的国内 Docker 镜像源
以下是一些常用的国内 Docker 镜像源地址:
- 阿里云:
https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
- 腾讯云:
https://mirror.ccs.tencentyun.com
- 华为云:
https://mirrors.huaweicloud.com/repository/docker-ce
- 中科大:
https://mirrors.ustc.edu.cn/docker-ce
- 网易:
https://mirrors.163.com/docker-ce
配置步骤
方法一:通过 Docker Desktop 界面配置
- 打开 Docker Desktop
- 点击右上角的设置图标(⚙️)
- 在左侧菜单中选择 “Docker Engine”
- 在右侧 JSON 配置中添加或修改
registry-mirrors
配置:
{
"registry-mirrors": [
"https://mirror.ccs.tencentyun.com",
"https://mirrors.aliyun.com",
"https://hub-mirror.c.163.com"
]
}
- 点击 “Apply & Restart” 按钮应用更改
方法二:直接修改配置文件
- 打开 Windows 资源管理器
- 导航到配置文件位置:
%UserProfile%\.docker\daemon.json
- 如果文件不存在,创建新文件
- 添加或修改以下内容:
{
"registry-mirrors": [
"https://mirror.ccs.tencentyun.com",
"https://mirrors.aliyun.com",
"https://hub-mirror.c.163.com"
]
}
- 保存文件
- 重启 Docker Desktop
验证配置
配置完成后,可以通过以下命令验证镜像源是否配置成功:
docker info
在输出信息中,找到 Registry Mirrors
部分,如果显示了你配置的镜像源地址,说明配置成功。
使用阿里云镜像源
如果你想使用阿里云的镜像源,还可以申请专属加速器:
- 登录阿里云控制台
- 搜索 “容器镜像服务”
- 在左侧菜单选择 “镜像工具 > 镜像加速器”
- 获取你的专属加速器地址
- 将该地址添加到
registry-mirrors
配置中
常见问题
1. 配置后无法拉取镜像
如果配置镜像源后仍然无法拉取镜像,可以尝试以下解决方案:
- 检查网络连接
- 确保配置文件格式正确(JSON 格式)
- 重启 Docker Desktop
- 尝试使用其他镜像源
2. 重启 Docker Desktop 失败
如果重启 Docker Desktop 失败,可以:
- 检查配置文件语法
- 删除配置文件重新配置
- 重启计算机
- 重新安装 Docker Desktop
最佳实践
-
配置多个镜像源:建议配置多个镜像源作为备份,当某个镜像源不可用时可以自动切换
-
定期更新配置:镜像源地址可能会变更,建议定期检查和更新配置
-
选择最快的镜像源:可以通过简单的拉取测试,选择在你的网络环境下最快的镜像源
# 测试镜像源速度
time docker pull nginx:latest
- 清理本地缓存:如果遇到问题,可以尝试清理 Docker 的本地缓存
# 清理未使用的镜像、容器和网络
docker system prune -a
总结
配置国内镜像源是提升 Docker 使用体验的重要步骤。通过本教程的配置,你可以显著提高 Docker 镜像的下载速度。记住要选择稳定可靠的镜像源,并定期维护配置以确保最佳性能。
如果你在配置过程中遇到任何问题,可以参考上述的故障排除步骤,或查看 Docker 的官方文档获取更多帮助。