Docker Desktop配置镜像加速器详细步奏(附常见问题)

1 阅读2分钟

配置镜像加速器

为什么要配置:Docker 默认的镜像仓库在海外,国内下载慢。配置国内镜像加速器后,下载速度会飙升。

配置步骤

  1. 在系统托盘(右下角任务栏)找到 Docker 鲸鱼图标,右键点击,选择 Settings

  2. 点击左侧菜单的 Docker Engine 选项卡。

  3. 在右侧配置框中,找到 registry-mirrors 字段(如果没有就手动添加)。 在这里插入图片描述

常用加速器地址

镜像加速器地址备注
轩辕镜像docker.xuanyuan.me免费公共源,无需注册
DaoClouddocker.m.daocloud.io老牌稳定,可作为备用
阿里云https://<你的ID>.mirror.aliyuncs.com需登录阿里云获取专属地址
腾讯云mirror.ccs.tencentyun.com仅限腾讯云内网使用

为了更稳定,强烈建议你添加至少两个地址,用逗号分隔,这样如果一个地址失效,Docker会自动尝试下一个。你可以参考下面的格式进行配置:

将你选择的加速器地址填入方括号内,多个地址用英文逗号分隔。

示例:

  {
    "registry-mirrors": [
     "https://docker.xuanyuan.me",
     "https://docker.m.daocloud.io"
   ]    }

点击 Apply & Restart 重启 Docker。 配置文件必须是合法的 JSON 格式,多一个逗号或少一个引号都会导致 Docker 启动失败。如果不确定,可以用 JSONLint 校验 常见错误:缺斜体样式少一个逗号 , 、多一个引号 " ,或者花括号 {} 不匹配,都会导致整个 Docker 服务无法启动

验证配置

打开终端,运行:

docker info

查看输出中是否有 Registry Mirrors 和你配置的地址。若显示成功,则加速器生效。 在这里插入图片描述

测试

配置完后可以在终端运行下面指令测试一下

  1. 拉取 Nginx 镜像(加速器生效后应该很快)

docker pull nginx:alpine

#2. 运行容器,将容器的80端口映射到本地的8080

docker run -d --name my-site -p 8080:80 nginx:alpine

#3. 打开浏览器,访问 http://localhost:8080,看到 Nginx 欢迎页

  1. 查看容器状态

docker ps

#5. 停止并删除容器

docker stop my-site docker rm my-site

常见问题

1.配置后Docker 无法启动, JSON 格式错误(多逗号、少引号)用 JSONLint 校验,修正格式。

如果改错了导致 Docker 启动失败,直接删除 daemon.json 文件,

C:\Users<用户名>.docker\daemon.json

Docker 就会恢复默认配置并正常启动。

2.配置后下载还是很慢 :地址失效/网络环境问题 ,换一个地址试试,或检查代理设置

3.docker info 看不到加速器: 未重启 Docker 点击 Apply & Restart 镜像拉取超时;网络不稳定,多试几次,或换时间段