在使用 Docker 時，我們經(jīng)常會通過 docker pull 命令獲取鏡像，但有時會遇到 pull 不下來的問題。本文總結了常見的失敗原因及對應的解決方法，適用于初學者和開發(fā)者查錯參考。

一、常見錯誤現(xiàn)象

1.net/http: request canceled while waiting for connection

2.Error response from daemon: Get https://registry-1.docker.io/v2/: net/http: TLS handshake timeout

3.connection refused

4.unauthorized: authentication required

5.denied: requested access to the resource is denied

6.Error response from daemon: manifest for xxx not found

二、解決方法匯總

1. 網(wǎng)絡連接問題

最常見的原因是網(wǎng)絡連接 Docker Hub 不穩(wěn)定或被墻：

解決方案：

檢查 DNS 設置，推薦使用阿里 DNS（223.5.5.5）或 Google DNS（8.8.8.8）：

編輯 /etc/resolv.conf，添加：

nameserver 8.8.8.8
nameserver 223.5.5.5

使用國內鏡像源，例如：

編輯 /etc/docker/daemon.json：

{
  "registry-mirrors": ["https://registry.docker-cn.com", "https://hub-mirror.c.163.com"]
}

重啟 Docker：

sudo systemctl daemon-reexec
sudo systemctl restart docker

2. 鏡像名稱錯誤或不存在

比如打錯鏡像名、版本號錯誤等。

解決方案：

確認鏡像名稱拼寫正確，例如：

docker pull nginx:latest

建議先通過 Docker Hub 網(wǎng)站或命令查找可用 tag：

docker search nginx

3. 權限問題（unauthorized）

有些鏡像倉庫（如私有倉庫）需要登錄授權。

解決方案：

使用 docker login 登錄：

docker login

然后重新 pull。

4. 鏡像 tag 不存在（manifest not found）

比如使用了錯誤的 tag。

解決方案：

先查看支持的 tag 列表：

docker pull image-name

或直接訪問：https://hub.docker.com/

5. 代理問題（公司網(wǎng)絡）

某些公司網(wǎng)絡需要設置代理才能正常連接 Docker Hub。

解決方案：

配置 Docker 的代理：

編輯 /etc/systemd/system/docker.service.d/http-proxy.conf：

[Service]
Environment="HTTP_PROXY=http://your-proxy.com:port/"
Environment="HTTPS_PROXY=http://your-proxy.com:port/"

重啟 Docker：

sudo systemctl daemon-reexec
sudo systemctl restart docker

6、無法在線 pull 鏡像？試試離線下載鏡像并導入

當服務器無法訪問外網(wǎng)、Docker Hub 被墻或出于內網(wǎng)環(huán)境部署需求，可以選擇離線下載 Docker 鏡像，然后導入到目標服務器中使用。

離線導入鏡像的完整流程如下：

Step 1：在可聯(lián)網(wǎng)的機器上下載鏡像

docker pull nginx:1.25

下載完成后，將鏡像保存為 tar 文件：

docker save -o nginx_1.25.tar nginx:1.25

Step 2：將 tar 包復制到目標服務器

可以使用 scp、U 盤、內網(wǎng)傳輸?shù)确绞綄?nginx_1.25.tar 拷貝至目標服務器。

scp nginx_1.25.tar user@192.168.x.x:/home/user/

Step 3：在目標服務器上導入鏡像

docker load -i nginx_1.25.tar

驗證鏡像是否導入成功：

docker images

輸出結果應包含 nginx:1.25

提示：

離線導入支持多個鏡像合并保存，例如：

docker save -o images.tar nginx:1.25 redis:7.2

同理，導入后也可用 docker tag 重命名或上傳至私有倉庫。

三、建議

遇到 pull 問題時，先執(zhí)行 docker info 查看當前配置。

多用官方鏡像，避免使用 tag 為 latest 造成不可控更新。

如果長期開發(fā)，建議搭建本地 Harbor 倉庫，提高效率。

到此這篇關于Docker無法pull鏡像的常見原因及解決方法匯總的文章就介紹到這了,更多相關Docker解決無法pull鏡像內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論