docker pull鏡像報錯:‘invalid checksum digest format‘解決
更新時間：2025年08月07日 09:44:23 作者：CN-FuWei
鏡像推送/拉取報錯,排查發(fā)現倉庫正常但Docker默認連接443端口,配置了安全連接,最終因宿主機443端口被占用,停掉沖突服務后問題解決
一、問題現象
在進行鏡像推送時，發(fā)生報錯：
docker push registry.example.com/nginx:xxx ... xxxx:Layers already exists xxxx:Layers already exists xxxx:Layers already exists xxxx:Layers already exists ... invalid checksum digest format
然后，從鏡像倉庫拉取鏡像，也報錯：
docker pull registry.example.com/nginx:xxx Error reponse from daemon : error unmarshalling content: invalid character '<' looking for beging of value
二、排查過程
2.1 檢查鏡像
docker load -i nginx:xxx docker images|grep nginx
鏡像可以導入本地，證明鏡像沒有問題。
2.2 檢查鏡像倉庫
docker version: 18.09.0
registry version: 1.1.0
檢查鏡像倉庫的運行狀態(tài)
docker ps |grep registry
繞過docker，通過Docker Registry API拉取鏡像 ：
curl -X GET http://your-registry/v2/<repository>/manifests/<tag> #將以下內容替換為實際的值： your-registry：你的 Registry 地址（例如，registry.example.com）。 <repository>： 你的鏡像倉庫名稱 <tag>： 你要拉取的鏡像標簽
這個命令將返回鏡像的 manifest（元數據），其中包含有關鏡像的詳細信息，包括層（layers）和配置。
然后，你可以提取 manifest 中的層信息，并使用 curl 命令拉取每個層。例如：
# 提取鏡像的層信息 layers=$(curl -s -H "Accept: application/vnd.docker.distribution.manifest.v2+json" http://your-registry/v2/<repository>/manifests/<tag> | jq -r '.layers[].digest') # 拉取每個層 for layer in $layers; do curl -O -J -L http://your-registry/v2/<repository>/blobs/$layer done
最終可以拉取成功，證明registry服務正常。
2.3 檢查docker服務
2.3.1 檢查服務運行狀態(tài)
systemctl status docker
2.3.2 檢查docker日志
journalctl -xe|grep docker
從這里可以看出docker默認去連接443端口
2.3.3 檢查docker配置文件
cat /usr/lib/systemd/system/docker.service
可以看到，已經配置了registry的安全連接。
三、解決方案
通過多次執(zhí)行docker push可以發(fā)現，連接會重置到443端口上，返回的類似是一個html的內容。
檢查宿主機的443端口有沒有監(jiān)聽：
netstat -tnulp|grep 443|grep LISTEN tcp 0 0.0.0.0:443 0.0.0.0:* LISTEN 101811/./httpServer
可以看到已經有服務監(jiān)聽了443端口，我們需要把這個服務給停掉。
最終鏡像可以正常推拉到鏡像倉庫！
總結
以上為個人經驗，希望能給大家一個參考，也希望大家多多支持腳本之家。
相關文章
在本文里我們給大家整理關于kubernetes作用領域以及可以做的項目和思路，有興趣的朋友們參考下。2019-06-06
這篇文章主要介紹了使用Docker創(chuàng)建FTP服務器的過程解析,使用?Docker?搭建?FTP?服務，不僅十分簡單，而且可以對宿主機有一定的隔離，對Docker創(chuàng)建FTP服務器的過程感興趣的朋友一起看看吧2022-04-04
在使用 Docker 進行應用容器化部署時,文件系統(tǒng)掛載（Volume Mount）是最常用的功能之一,也是問題高發(fā)區(qū),本文給大家介紹了Docker掛載文件結果是目錄問題的解決方案,需要的朋友可以參考下2025-05-05
本文主要介紹了MacOS?Docker?安裝的實現步驟，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-06-06
Docker consul的容器服務更新與發(fā)現的問題小結
這篇文章主要介紹了Docker consul的容器服務更新與發(fā)現,講解了服務注冊與發(fā)現的基本概念講解，本文給大家介紹的非常詳細，需要的朋友可以參考下2021-08-08
這篇文章主要給大家介紹了關于Docker新手初探之常用命令實踐的相關資料，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面來一起學習學習吧2020-08-08
這篇文章主要介紹了docker mysql啟動時執(zhí)行初始化sql問題，本文通過實例代碼給大家介紹的非常詳細，具有一定的參考借鑒價值 ,需要的朋友可以參考下2019-05-05
這篇文章主要介紹了Docker連接mongodb實現過程及代碼案例,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-09-09
這篇文章主要介紹了docker容器直接退出，如何進入容器調試,本文給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2022-09-09
這篇文章主要介紹了docker重新加載nginx配置方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-08-08