Docker镜像加速使用说明

Docker 镜像加速完整使用说明(CentOS7 Linux + Windows Docker Desktop)

原理:Docker 默认从国外 Docker Hub 拉镜像,国内网络慢、超时;镜像加速器是国内缓存节点,优先从国内节点下载镜像,大幅提速。 核心配置文件:/etc/docker/daemon.json(Linux)

一、Linux(CentOS7)一键配置(推荐复制直接执行)

# 1.创建docker配置目录
mkdir -p /etc/docker

# 2.写入daemon.json,配置多个国内加速源(多源容错,一个失效自动换下一个)
tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.mirrors.ustc.edu.cn",
    "https://docker.1ms.run"
  ]
}
EOF

# 3.重新加载systemd配置,重启docker生效
systemctl daemon-reload
systemctl restart docker

✅ 验证加速是否生效

docker info

往下翻找到 Registry Mirrors,能看到上面配置的地址,说明成功。

测试拉取镜像

docker pull nginx

⚠️ 重要注意:daemon.json 必须严格 JSON 格式,不能有中文注释,逗号不能多写,格式错误 Docker 启动失败!

二、可用国内加速地址清单

表格

加速器地址
DaoCloudhttps://docker.m.daocloud.io
中科大https://docker.mirrors.ustc.edu.cn
1ms 镜像https://docker.1ms.run
南京大学https://docker.nju.edu.cn

阿里云:登录阿里云控制台,获取个人专属加速器地址(云服务器推荐用同厂商专属加速)

三、Windows Docker Desktop 配置镜像加速

  1. 打开 Docker Desktop → 设置 Settings → Docker Engine
  2. 在右侧 JSON 框内填入下面配置:
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.mirrors.ustc.edu.cn",
    "https://docker.1ms.run"
  ]
}
  1. 点击 Apply & restart 应用并重启 Docker
  2. 打开 PowerShell 执行 docker info 验证镜像源

四、daemon.json 扩展常用参数(生产推荐)

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.mirrors.ustc.edu.cn"
  ],
  "log-driver":"json-file",
  "log-opts": {"max-size":"100m","max-file":"3"},
  "live-restore":true
}
  • log:限制容器日志大小,防止磁盘占满
  • live-restore:docker 重启,容器不退出

五、常见故障排查

1. docker 重启失败 Job for docker.service failed

90% 是json 语法错误

# 查看详细报错
journalctl -u docker

检查:逗号、引号,不要加 // 注释。

2. docker info 看不到 mirrors

  • 确认执行 systemctl daemon-reload 再重启 docker
  • 文件路径:/etc/docker/daemon.json,不是别的目录

3. 加速地址失效,拉镜像依旧很慢

删除失效源,更换其他可用镜像地址,多写几个源做容错。

4. 云服务器安全组

镜像加速走443 端口,不需要额外放行端口,出站默认开放。

六、基础 Docker 常用命令(配套你部署 OpenWebUI)

docker info                    #查看docker信息,验证镜像加速
docker pull 镜像名              #拉取镜像
docker images                  #列出本地镜像
docker rm 容器ID                #删除容器
docker rmi 镜像ID               #删除镜像
docker ps                      #查看运行容器
docker ps -a                   #查看全部容器(含停止)

七、补充:containerd 环境(k8s)

如果是 containerd 而不是 docker,配置文件 /etc/containerd/config.toml,修改[plugins."io.containerd.grpc.v1.cri".registry.mirrors]段配置镜像加速。

八、安全提示

  1. 公共免费镜像加速器适合开发测试;企业生产建议自建 Harbor 私有仓库。
  2. 加速仅缓存 Docker Hub 公共镜像,私有镜像不会被缓存。
  3. 加速器地址可能不定期失效,建议配置多个备用。
© 版权声明
THE END
喜欢就支持一下吧
点赞10 分享
评论 抢沙发
头像-次元社
欢迎您留下宝贵的见解!
提交
头像-次元社

昵称

取消
昵称表情代码图片快捷回复

    暂无评论内容