安装Quay镜像仓库时出现exit status 125错误，求排查解决办法
2026-7-16
问题
下载mirror-registry后执行./mirror-registry install时触发exit status 125错误，错误日志如下：
__ __ / \ / \ ______ _ _ __ __ __ / /\ / /\ \ / __ \ | | | | / \ \ \ / / / / / / \ \ | | | | | | | | / /\ \ \ / \ \ \ \ / / | |__| | | |__| | / ____ \ | | \ \/ \ \/ / \_ ___/ \____/ /_/ \_\ |_| \__/ \__/ \ \_\ \___\ by Red Hat Build, Store, and Distribute your Containers INFO[2023-07-07 11:27:57] Install has begun INFO[2023-07-07 11:27:57] Found execution environment at /home/osboxes/demo-project/execution-environment.tar INFO[2023-07-07 11:27:57] Loading execution environment from execution-environment.tar ERRO[2023-07-07 11:27:58] An error occurred: exit status 125
原因分析
exit status 125是Docker容器执行阶段的典型错误码，结合mirror-registry的安装流程，可能的触发原因包括：
- 执行环境镜像文件
execution-environment.tar损坏或不完整，导致Docker无法正常加载镜像 - 当前执行用户无Docker操作权限，无法调用Docker daemon完成镜像加载
- Docker daemon未启动或运行异常，无法处理镜像加载请求
- 磁盘剩余空间不足，无法完成镜像解压与加载操作
修复方案
针对上述可能的原因，逐一排查修复：
- 重新获取执行环境镜像
- 删除损坏的镜像文件：
rm /home/osboxes/demo-project/execution-environment.tar - 重新下载对应版本的镜像文件，确保下载过程无中断，必要时校验文件哈希值
- 删除损坏的镜像文件：
- 修复Docker权限问题
- 检查当前用户是否属于docker用户组：
groups | grep docker - 若未加入组，执行命令添加：
sudo usermod -aG docker $USER，之后重新登录会话使权限生效 - 临时可通过sudo执行安装命令：
sudo ./mirror-registry install
- 检查当前用户是否属于docker用户组：
- 检查并恢复Docker daemon状态
- 查看Docker服务状态：
systemctl status docker - 若服务未启动，执行启动命令：
sudo systemctl start docker - 设置开机自启避免后续问题：
sudo systemctl enable docker
- 查看Docker服务状态：
- 清理磁盘空间
- 查看磁盘使用情况：
df -h - 清理冗余文件或镜像，确保Docker存储目录（默认
/var/lib/docker）有足够剩余空间
- 查看磁盘使用情况：
内容的提问来源于stack exchange，提问作者Amiya Dey
相关产品推荐
相关产品推荐
