> 技术文档 > Docker 学习入门篇:国内镜像源配置全攻略_docker镜像库国内源

Docker 学习入门篇:国内镜像源配置全攻略_docker镜像库国内源


Docker 学习入门篇:国内镜像源配置全攻略

一、为什么需要切换Docker国内镜像源?

在国内使用Docker时,默认的官方镜像源Docker Hub由于网络限制,经常出现拉取镜像速度慢、超时甚至连接拒绝的问题。例如,执行docker run命令时可能会遇到以下错误:

Error response from daemon: Get \"https://registry-1.docker.io/v2/\": net/http: request canceled while waiting for connection

此时,配置国内镜像源成为提升开发效率的必备操作。国内镜像源由阿里云、网易云、中科大等机构提供,不仅下载速度更快,还能避免网络不稳定导致的中断问题。

二、准备工作

  • 系统要求:Linux(推荐Ubuntu/Debian/CentOS)、Windows 10+或macOS(需安装Docker Desktop)。
  • 权限要求:Linux用户需具备sudo权限,Windows/macOS用户需以管理员身份运行Docker Desktop。

三、配置国内镜像源的三种方式

方式一:Linux系统手动配置(推荐)

1. 修改Docker配置文件

Docker通过/etc/docker/daemon.json文件管理镜像源配置。如果文件不存在,需要手动创建:

sudo vim /etc/docker/daemon.json
2. 写入镜像源地址

将以下国内镜像源地址复制到文件中

{  \"registry-mirrors\": [ \"https://hub-mirror.c.163.com\", \"https://docker.hpcloud.cloud\", \"https://docker.m.daocloud.io\" , \"https://docker.unsee.tech\", \"https://docker.1panel.live\", \"https://mirrors.ustc.edu.cn\", \"https://docker.chenby.cn\", \"https://mirrors.azure.cn\", \"htt