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

Docker修改容器内部文件的3种简单方法
docker容器化技术在打包生产和发布中占据着更高的地位,其高效简便很有亮点,下面这篇文章主要给大家介绍了关于Docker修改容器内部文件的3种简单方法,文中通过代码介绍的非常详细,需要的朋友可以参考下
2024-05-05
Docker网络之部署redis集群方式
文章介绍了如何部署和测试Redis集群,包括创建配置文件、启动容器、查看集群信息以及模拟节点故障进行测试
2025-01-01
Docker 网络代理配置及防火墙设置的方法步骤
在服务器无法直接访问外网的环境中,Docker命令需要通过网络代理连接,本文就来介绍一下Docker 网络代理配置及防火墙设置的方法步骤,感兴趣的可以了解一下
2024-10-10
Docker容器定时备份数据库并发送到指定邮箱(设计思路)
这篇文章主要介绍了Docker容器定时备份数据库并发送到指定邮箱,文中写了一下shell脚本，逻辑也很简单，当前时间与启动时间相同时，则调用sendmail函数发送邮件，具体脚本跟随小编一起看看吧
2022-01-01
Docker搭建 Nginx+PHP+MySQL 环境并部署WordPress实践
本文给大家分享的是作者基于Docker搭建 Nginx+PHP+MySQL 环境并部署WordPress的详细过程，非常的全面，有需要的小伙伴可以参考下
2017-02-02
部署维护docker环境的详细教程
这篇文章主要介绍了部署维护docker环境的详细教程,非常不错，具有参考借鉴价值，需要的朋友可以参考下
2017-02-02
如何将gitbub下载的docker-compose项目运行在docker
这篇文章主要介绍了如何将gitbub下载的docker-compose项目运行在docker问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-05-05
Ubuntu24.04LTS在线安装Docker引擎的详细过程
本文介绍了在Ubuntu 24.04 LTS系统上安装Docker引擎的步骤,包括卸载旧版本、设置Docker APT仓库、安装最新版或指定版本的Docker,本文给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧
2024-11-11
docker用root进入容器的操作
这篇文章主要介绍了docker用root进入容器的操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-03-03
Linux环境下使用Docker搭建Jenkins容器的方法步骤
本文主要介绍了Linux环境下使用Docker搭建Jenkins容器的方法步骤，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-06-06