docker拉镜像失败终极解决方案

更新时间：2025年10月21日 09:04:45 作者：ARMFUN

本文主要介绍了docker拉镜像失败终极解决方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

1、配置服务器需要走socks5代理

1. 配置 Docker 服务代理（推荐）

创建目录（如果不存在）：

sudo mkdir -p /etc/systemd/system/docker.service.d

创建或编辑代理配置文件：

sudo nano /etc/systemd/system/docker.service.d/proxy.conf

写入（假设你的 SOCKS5 代理是 127.0.0.1:1080）：

[Service]
Environment="HTTP_PROXY=socks5h://127.0.0.1:1080"
Environment="HTTPS_PROXY=socks5h://127.0.0.1:1080"
Environment="NO_PROXY=localhost,127.0.0.1"

注意 socks5h:// 可以让 DNS 请求也通过代理，防止解析失败。

重载 systemd 并重启 Docker：

sudo systemctl daemon-reload
sudo systemctl restart docker

2、临时使用环境变量（快速测试）

在命令前加代理环境变量：

export HTTP_PROXY=socks5h://127.0.0.1:1080
export HTTPS_PROXY=socks5h://127.0.0.1:1080

sudo docker pull lvxj11/erpnext:latest

3、其他常见原因

本地 DNS 解析失败 → socks5h 可以解决
防火墙 / NAT 屏蔽 → 确认能 ping registry-1.docker.io
Docker 版本太老 → 升级到最新稳定版
网络慢 → 增加超时时间（不常用）

4、验证代理是否生效

sudo docker info | grep -i proxy

输出类似：

HTTP Proxy: socks5h://127.0.0.1:1080
HTTPS Proxy: socks5h://127.0.0.1:1080

表示配置生效。

到此这篇关于docker拉镜像失败终极解决方案的文章就介绍到这了,更多相关docker拉镜像失败内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Docker拉镜像报错error pulling image configuration: unknown blob

以示例讲解Clickhouse Docker集群部署以及配置
这篇文章主要介绍了Clickhouse Docker集群部署及配置，示例讲解的非常详细，希望可以帮助到有需要的小伙伴
2021-08-08
docker daemon远程连接设置详解
本篇文章主要介绍了docker daemon远程连接设置详解，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-04-04
Docker终端无法输入中文问题及解决
Docker终端输入中文问题可通过修改语言环境解决,系统默认POSIX字符集不支持中文,将环境变量LANG设置为C.UTF-8即可解决,方法包括启动容器时添加环境变量和进入容器后修改
2024-11-11
docker-compose启动服务方式
这篇文章主要介绍了docker-compose启动服务方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-05-05
解决docker搭建gitlab时容器不停重启的问题
这篇文章主要介绍了docker搭建gitlab时容器不停重启的问题,当用docker log 查看日志时，发现问题是在于配置文件没有权限创建的问题，本文给大家分享解决方案，感兴趣的朋友一起看看吧
2022-05-05
Windows系统下装Docker至D盘/其他盘最新方法(最准确，直接装)
这篇文章主要介绍了Windows系统下装Docker至D盘/其他盘的相关资料,为了避免C盘空间不足的问题,通过修改安装路径,可以将Docker的数据存储在D盘的特定文件夹中,从而有效地管理磁盘空间,需要的朋友可以参考下
2025-04-04
Docker registry私有镜像仓库服务部署案例演示
这篇文章主要为大家介绍了Docker registry私有镜像仓库服务部署案例演示，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步早日升职加薪
2022-04-04
Docker中redis安装及测试教程
这篇文章主要介绍了Docker中redis安装及测试教程的一些基础方法和知识，为后续安装部署redis集群做准备，需要的朋友可以参考下
2022-11-11
docker安装java环境的实现步骤
这篇文章主要介绍了docker安装java环境的实现步骤，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-12-12
Docker如何实现修改Docker0网桥默认网段
这篇文章主要介绍了Docker如何实现修改Docker0网桥默认网段，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-12-12