前言

本文聚焦于解決 Docker 鏡像拉取報錯 “Error response from daemon: Get https://registry-1.docker.io/v2/: dial tcp …: i/o timeout” 問題，從 DNS 解析優(yōu)化（修改 /etc/resolv.conf、在 daemon.json 中指定 DNS、編輯 /etc/hosts）、代理配置（systemd 級 HTTP_PROXY/HTTPS_PROXY、NO_PROXY 繞過 Docker Hub、客戶端臨時代理）、鏡像 （配置國內 registry-mirrors、單次拉取 ）、超時重試（DOCKER_CLIENT_TIMEOUT、COMPOSE_HTTP_TIMEOUT）、服務重啟（systemctl restart docker、Docker Desktop 重啟）、網絡狀態(tài)檢查（ping、curl 診斷、NAT 與橋接模式、iptables/firewalld 防火墻、安全組開放 443 端口）、系統(tǒng)時間同步（ntpdate）、MTU 調整、私有 Registry 支持、 穿透等多維度排查與實戰(zhàn)方案，助力 Ubuntu、CentOS、macOS、Docker Desktop 等多環(huán)境下，快速定位并徹底解決 Docker pull 超時、dial tcp、網絡中斷、鏡像源被Q、代理配置不當、DNS 解析失敗等常見故障，實現(xiàn) Docker 鏡像拉取穩(wěn)定性與 優(yōu)化。

一、摘要

在使用 Docker 拉取鏡像時，常常會遇到以下錯誤：

Error response from daemon: Get “https://registry-1.docker.io/v2/”: dial tcp …: i/o timeout

該問題通常由 DNS 解析失敗、網絡連接中斷、代理設置不當、鏡像源被墻或超時限制等多種因素引起。本文將匯總全網最新的實戰(zhàn)方案，按四大方向分類——DNS 解析優(yōu)化、代理配置、鏡像 與超時調整，以及服務重啟與網絡狀態(tài)檢查，并在此基礎上擴展更多排查和優(yōu)化思路，幫助你快速定位并徹底解決該錯誤。

二、開發(fā)環(huán)境

• 操作系統(tǒng)：Ubuntu 20.04 / CentOS 7 / macOS
• Docker 版本：20.10.x
• 網絡環(huán)境：公司內網、校園網及家庭寬帶均適用

三、錯誤場景與技術細節(jié)

異常復現(xiàn)場景

執(zhí)行命令：

docker pull nginx:latest

控制臺輸出：

Error response from daemon: Get “https://registry-1.docker.io/v2/”: dial tcp 34.194.164.123:443: i/o timeout

可能觸發(fā)因素

在排查該問題時，千萬不要漏掉任何一環(huán)，從本地 DNS、操作系統(tǒng)級網絡，到 Docker 配置，每一步都可能是“罪魁禍首”。

四、解決方案詳解

DNS 解析優(yōu)化

配置/etc/resolv.conf

sudo vim /etc/resolv.conf
# 添加公共 DNS
nameserver 8.8.8.8
nameserver 8.8.4.4
# 如在國內網絡，可再追加
nameserver 114.114.114.114

在 Docker Daemon 中指定 DNS

編輯 /etc/docker/daemon.json，加入：

{
  "dns": ["8.8.8.8", "8.8.4.4"]
}

然后重啟：

sudo systemctl daemon-reload
sudo systemctl restart docker

編輯/etc/hosts（臨時方案）

# 先通過 dig 獲取 IP
dig registry-1.docker.io +short
# 然后在 /etc/hosts 中添加
34.228.211.243 registry-1.docker.io

代理配置

Daemon 級代理

創(chuàng)建或編輯 /etc/systemd/system/docker.service.d/https-proxy.conf：

[Service]
Environment="HTTP_PROXY=http://proxy.example.com:80"
Environment="HTTPS_PROXY=http://proxy.example.com:443"
Environment="NO_PROXY=registry-1.docker.io,localhost,127.0.0.1"

重載并重啟：

sudo systemctl daemon-reload
sudo systemctl restart docker

客戶端臨時代理

export HTTP_PROXY="http://proxy.example.com:80"
export HTTPS_PROXY="http://proxy.example.com:443"
docker pull nginx:latest

鏡像與超時調整

配置國內鏡像器

在 /etc/docker/daemon.json 中添加：

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.mirrors.ustc.edu.cn",
    "http://hub-mirror.c.163.com"
  ]
}

備用：

{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.domys.cc",
    "https://docker.imgdb.de",
    "https://docker-0.unsee.tech",
    "https://docker.hlmirror.com",
    "https://cjie.eu.org",
    "https://docker.m.daocloud.io",
    "https://hub.rat.dev",
    "https://docker.1panel.live",
    "https://docker.rainbond.cc"
  ]
}

重啟 Docker 生效。

單次拉取

export REPO=docker.m.daocloud.io
docker pull ${REPO}/library/nginx:latest

增加超時重試

export DOCKER_CLIENT_TIMEOUT=120
export COMPOSE_HTTP_TIMEOUT=120

服務重啟與網絡狀態(tài)檢查

重啟 Docker 服務

sudo systemctl restart docker

有時僅重啟 daemon 即可立刻恢復。

檢查主機網絡

• 確認宿主機/VM 已聯(lián)網，必要時切換 NAT 或橋接模式
• 使用 ping registry-1.docker.io、curl -vvv https://registry-1.docker.io/v2/ 診斷

防火墻 & 安全組

檢查 iptables、firewalld、云平臺安全組是否開放 443 端口

臨時關閉防火墻測試：

sudo systemctl stop firewalld
sudo iptables -F

更多擴展方案

五、方案總結

到此這篇關于docker拉取鏡像報錯:Error response from daemon: Get “https://registry-1.docker.io/v2/“: dial tcp的解決方案的文章就介紹到這了,更多相關docker拉取鏡像超時報錯內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論