快捷導(dǎo)航

Docker鏡像下載的常見(jiàn)問(wèn)題及解決辦法

更新時(shí)間：2024年10月24日 10:22:50 作者：IT小輝同學(xué)

在使用Docker時(shí),用戶常遇到下載鏡像錯(cuò)誤,如TLS握手超時(shí)、請(qǐng)求取消等,主要由網(wǎng)絡(luò)狀況、配置問(wèn)題或DockerHub服務(wù)導(dǎo)致,本文就來(lái)介紹了一下幾種解決方法,感興趣的可以了解一下

引言

在使用 Docker 時(shí)，用戶常常會(huì)遇到下載鏡像的錯(cuò)誤，尤其是在網(wǎng)絡(luò)條件不佳或訪問(wèn) Docker Hub 時(shí)。這些問(wèn)題不僅影響開(kāi)發(fā)效率，還可能導(dǎo)致項(xiàng)目進(jìn)展緩慢。本文將介紹一些常見(jiàn)的錯(cuò)誤信息及其解決方案，幫助用戶更順暢地進(jìn)行鏡像管理。

常見(jiàn)錯(cuò)誤及原因

錯(cuò)誤信息

請(qǐng)求取消
Get https://registry-1.docker.io/v2/: net/http: request canceled

TLS 握手超時(shí)
Error response from daemon: Get https://index.docker.io/v1/search?q=mysql&n=25: net/http: TLS handshake timeout

鏡像下載超時(shí)
Error response from daemon: Get https://registry-1.docker.io/v2/: net/http: TLS handshake timeout

這些錯(cuò)誤通常是由于網(wǎng)絡(luò)不穩(wěn)定、Docker 配置不當(dāng)或 Docker Hub 服務(wù)不佳導(dǎo)致的。

在這里插入圖片描述

解決方案

使用國(guó)內(nèi)鏡像源

由于 Docker Hub 在國(guó)內(nèi)的訪問(wèn)速度可能較慢，建議使用國(guó)內(nèi)的鏡像源來(lái)加速下載。以下是步驟：

配置 Docker Daemon

在 /etc/docker/daemon.json 文件中添加以下內(nèi)容，以設(shè)置鏡像加速器：

  {
	"registry-mirrors" : [
	    "https://jkfdsf2u.mirror.aliyuncs.com",
	    "https://registry.docker-cn.com"
	  ],
	  "insecure-registries" : [
	    "docker-registry.zjq.com"
	  ],
	  "log-driver": "json-file",
	  "log-opts": {
	    "max-size": "10m",
	    "max-file": "10"
	  },
	  "data-root": "/data/docker"
	}

這個(gè)配置文件是 Docker 的 daemon.json，用于設(shè)置 Docker 的運(yùn)行時(shí)參數(shù)。具體說(shuō)明如下：

registry-mirrors：指定 Docker 鏡像的鏡像源，加速鏡像下載。
- "https://jkfdsf2u.mirror.aliyuncs.com" 和 "https://registry.docker-cn.com" 是兩個(gè)鏡像源。
insecure-registries：允許不安全的注冊(cè)表，這里列出了一個(gè)不安全的 Docker 注冊(cè)表 docker-registry.zjq.com。
log-driver：指定日志驅(qū)動(dòng)，這里使用 json-file，表示日志將以 JSON 格式存儲(chǔ)。
log-opts：設(shè)置日志選項(xiàng)，max-size 限制單個(gè)日志文件的大小為 10MB，max-file 設(shè)置最多保留 10 個(gè)日志文件。
data-root：指定 Docker 數(shù)據(jù)的存儲(chǔ)路徑，這里設(shè)置為 /data/docker。

在這里插入圖片描述

如果該鏡像源不可用，可以嘗試其他選項(xiàng)，比如 DaoCloud 鏡像。

重啟 Docker 服務(wù)

進(jìn)行配置更改后，需要重啟 Docker 服務(wù)以應(yīng)用更改：

systemctl restart docker.service

手動(dòng)指定鏡像源

如果使用 docker pull nginx:1.27.0 命令仍然失敗，可以手動(dòng)指定鏡像源進(jìn)行下載：

docker pull hub.daocloud.io/nginx:1.27.0

這種方法在默認(rèn)倉(cāng)庫(kù)無(wú)法訪問(wèn)或速度緩慢時(shí)尤為有效。

在這里插入圖片描述

了解為何默認(rèn)命令可能失敗

使用 docker pull nginx:1.27.0 直接從 Docker Hub 下載時(shí)，可能會(huì)遇到網(wǎng)絡(luò)延遲或其他問(wèn)題，導(dǎo)致請(qǐng)求超時(shí)。指定鏡像源可以繞過(guò)這些問(wèn)題，確保下載過(guò)程更加順利。