【开发报错&答疑】解决Docker拉取镜像时 i/o timeout错误

帐篷Li-物联网布道师

发布于 2026-04-02 15:19:27

1390

文章被收录于专栏：开源物联网平台开发开源物联网平台开发

一，设置Docker镜像源（推荐）

1.1 解决方案1：配置加速地址

1.2 解决方案2：使用代理拉取镜像

1.3 解决方案3：备用办法：直接传送镜像

二，目前可用的镜像源

一，设置Docker镜像源（推荐）

阿里云提供了镜像源：阿里镜像申请地址登录后你会获得一个专属的地址

使用命令设置国内镜像源：通过vim /etc/docker/daemon.json 进入修改添加 registry-mirrors 内容后重启 Docker

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": ["https://<your_code>.mirror.aliyuncs.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

此命令会创建一个 /etc/docker/daemon.json 文件，并将国内源的配置写入其中。然后你只需要重启 Docker 服务即可使配置生效，可以通过运行 sudo systemctl restart docker 命令来重启 Docker 服务。

1.1 解决方案1：配置加速地址

配置加速地址：适用于Ubuntu 16.04+、Debian 8+、CentOS 7+

方式一：使用以下命令设置registry mirror：但是需要重启docker服务

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": [
"https://do.nark.eu.org",
"https://dc.j8.work",
"https://docker.m.daocloud.io",
"https://dockerproxy.com",
"https://docker.mirrors.ustc.edu.cn",
"https://docker.nju.edu.cn"
    ]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

检查加速是否生效：

查看docker系统信息 docker info，如果从输出结果中看到了 registry mirror 刚配置的内容地址，说明配置成功。

方式二：如果您当前有正在运行的容器不方便重启Docker服务，则不用设置环境也可以直接使用，用法示例：

docker pull do.nark.eu.org/library/mysql:5.7

第三方镜像：

AtomHub 可信镜像中心 - 大部分需要的镜像都是有的。

可信镜像中心官网：https://atomhub.openatom.cn/

通过搜索需要的镜像名称，进行pull拉取，用法示例：

docker pull atomhub.openatom.cn/amd64/redis:7.0.13

注意：docker compose 中要执行部署时，可以把版本与 atomhub 提供的版本匹配上，之后通过【拉取命令】进行单独拉取后，在执行 docker compose 就可以了。

1.2 解决方案2：使用代理地址拉取镜像

第一步：创建配置文件
sudo mkdir -p /etc/systemd/system/docker.service.d
sudo vim /etc/systemd/system/docker.service.d/http-proxy.conf

第二步：在文件中添加代理
[Service]
Environment="HTTP_PROXY=socks5://user:pass@127.0.0.1:1080"
Environment="HTTPS_PROXY=socks5://user:pass@127.0.0.1:1080"

第三步：重启Docker
sudo systemctl daemon-reload
sudo systemctl restart docker

第四步：查看环境变量
sudo systemctl show --property=Environment docker

1.3 解决方案3：导出别人拉取好的压缩包，用docker加载

别人拉取镜像后打包压缩到本地，然后传输到服务器，myimage为镜像名

1.服务器导出Docker镜像
docker save myimage > myimage.tar
2.复制压缩包到运行服务器
scp myimage.tar root@192.0.2.0:/home 
3.B服务器加载Docker镜像
docker load -i myimage.tar
4.查看镜像
docker images

或者使用export命令
1.docker export myimage > myimage.tar

2.docker import myimage.tar myimage

二，目前可用的镜像源

拉取 pull 镜像时，建议同时配置多个镜像源。

DaoCloud  https://docker.m.daocloud.io
阿里云  https://<your_code>.mirror.aliyuncs.com
Docker  https://dockerproxy.com
百度云  https://mirror.baidubce.com
南京大学  https://docker.nju.edu.cn
中科院  https://mirror.iscas.ac.cn

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2024-08-28，如有侵权请联系 cloudcommunity@tencent.com 删除

timeout