nmaguiar/imgutils

nmaguiar

集成docker、helm、skopeo、dive、crictl工具的容器镜像，用于容器开发、运维及镜像管理操作。

1 次收藏下载次数: 0状态：社区镜像维护者：nmaguiar仓库类型：镜像最近更新：28 天前

让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

ImgUtils Docker镜像文档

镜像概述和主要用途

ImgUtils 是一个基于 Alpine Linux 的 Docker 镜像（nmaguiar/imgutils），集成了一系列容器和 Kubernetes 镜像管理工具。该镜像旨在为 Kubernetes 集群内部提供一站式镜像管理能力，支持镜像复制、容器运行时访问、镜像内容检查等操作。

同时提供精简版本 nmaguiar/imgutils:lite，仅包含核心工具 crictl，适用于仅需容器运行时交互的场景。

核心功能和特性

集成工具集

skopeo：跨容器仓库镜像复制、检查和管理工具
helm：Kubernetes 包管理器，支持 Helm Chart 管理和 OCI 仓库交互
docker-cli：Docker 命令行工具，用于与 Docker 守护进程交互
crictl：Kubernetes CRI (容器运行时接口) 命令行工具，支持与 containerd/crio 等运行时交互
dive：镜像层分析工具，可视化展示镜像分层结构和内容
openaf：集成 DockerRegistry、Kube、oafp 模块的自动化工具
mc (Midnight Commander)：终端文件管理器，用于镜像内容浏览

使用场景和适用范围

适用场景

跨容器仓库（如私有仓库、公共仓库）的镜像/Helm Chart 复制与同步
Kubernetes 集群内节点级容器运行时（containerd/crio）的直接访问与管理
镜像内容检查、分层分析及安全审计
Docker 守护进程本地或远程访问（需挂载 Docker 套接字）

支持环境

Kubernetes 发行版：AWS EKS、K3S/K3D、OpenShift
容器运行时：containerd、crio
部署方式：Docker 本地运行、Kubernetes 集群内临时 Pod 部署

镜像安全扫描

https://raw.githubusercontent.com/nmaguiar/imgutils/main/.github/sec-build.svg](https://raw.githubusercontent.com/nmaguiar/imgutils/main/.github/sec-build.md)
https://raw.githubusercontent.com/nmaguiar/imgutils/main/.github/sec-latest.svg](https://raw.githubusercontent.com/nmaguiar/imgutils/main/.github/sec-latest.md)
https://raw.githubusercontent.com/nmaguiar/imgutils/main/.github/sec-build-lite.svg](https://raw.githubusercontent.com/nmaguiar/imgutils/main/.github/sec-build-lite.md)
https://raw.githubusercontent.com/nmaguiar/imgutils/main/.github/sec-lite.svg](https://raw.githubusercontent.com/nmaguiar/imgutils/main/.github/sec-lite.md)

版本信息

!https://raw.githubusercontent.com/nmaguiar/imgutils/main/.github/build-versions.svg
!https://raw.githubusercontent.com/nmaguiar/imgutils/main/.github/latest-versions.svg

使用方法和配置说明

环境变量说明

环境变量	说明	默认值
`CONTAINER_RUNTIME_ENDPOINT`	容器运行时接口端点（供 crictl 使用）	`unix:///run/containerd/containerd.sock`

1. 完整版镜像（nmaguiar/imgutils）

Docker 本地运行

直接通过 Docker 运行，挂载 Docker 套接字以访问本地 Docker 守护进程：

bash
docker run --rm -ti -v /var/run/docker.sock:/var/run/docker.sock nmaguiar/imgutils sudo /bin/bash

Kubernetes 集群内运行

需通过 kubectl run 在目标节点部署临时 Pod，以下为不同 Kubernetes 环境的部署命令：

前提条件

已获取目标节点名称（通过 kubectl get nodes 查看）
集群已配置适当权限（如 kube-system 命名空间访问权限）

AWS EKS 环境

bash
NODENAME=ec2-server-0 NAME=imgutils HPATH=/run/containerd/containerd.sock  /bin/sh -c 'kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils\",\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/containerd/containerd.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/containerd/containerd.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

K3S/K3D 环境

bash
NODENAME=k3s-server-0 NAME=imgutils HPATH=/run/k3s/containerd/containerd.sock  /bin/sh -c 'kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils\",\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/containerd/containerd.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/containerd/containerd.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

OpenShift 环境

bash
NODENAME=server-0 NAME=imgutils HPATH=/var/run/crio/crio.sock  /bin/sh -c './kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils\",\"securityContext\":{\"privileged\":true},\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/crio/crio.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/crio/crio.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

参数说明：

NODENAME：目标节点名称（需替换为实际节点名）
NAME：临时 Pod 名称（自定义，如 imgutils）
HPATH：容器运行时套接字路径（根据环境调整，如 containerd 为 /run/containerd/containerd.sock）

2. 精简版镜像（nmaguiar/imgutils:lite）

仅包含 crictl 工具，适用于轻量级容器运行时交互，部署命令与完整版类似，仅需将镜像标签改为 :lite：

AWS EKS 环境

bash
NODENAME=ec2-server-0 NAME=imgutils HPATH=/run/containerd/containerd.sock  /bin/sh -c 'kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils:lite\",\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/containerd/containerd.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/containerd/containerd.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

K3S/K3D 环境

bash
NODENAME=k3s-server-0 NAME=imgutils HPATH=/run/k3s/containerd/containerd.sock  /bin/sh -c 'kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils:lite\",\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/containerd/containerd.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/containerd/containerd.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

OpenShift 环境

bash
NODENAME=server-0 NAME=imgutils HPATH=/var/run/crio/crio.sock  /bin/sh -c './kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils:lite\",\"securityContext\":{\"privileged\":true},\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/crio/crio.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/crio/crio.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

操作指南

镜像和 Helm Chart 在仓库间复制

步骤 1：启动 ImgUtils 环境

bash
# Docker 本地环境
docker run --rm -ti nmaguiar/imgutils sudo /bin/bash

# Kubernetes 集群环境
kubectl run imgutils --rm -ti --image=nmaguiar/imgutils -- sudo /bin/bash

步骤 2：登录源仓库和目标仓库

使用 skopeo login 登录两个仓库（支持 --password-stdin 避免明文密码输入）：

bash
# 登录源仓库 A
skopeo login a.registry -u userA --password-stdin
[输入 userA 密码后按 Ctrl+D 确认]

# 登录目标仓库 B
skopeo login b.registry -u userB --password-stdin
[输入 userB 密码后按 Ctrl+D 确认]

步骤 3：复制镜像或 Helm Chart

复制镜像（--all 保留所有平台架构）：

bash
skopeo copy --all docker://a.registry/some/image:1.2.3 docker://b.registry/some/image:1.2.3

复制 Helm Chart（Helm Chart 通常以 OCI 镜像形式存储）：

bash
skopeo copy --all docker://a.registry/some/chart:1.2.3 docker://b.registry/some/chart:1.2.3

步骤 4：退出环境

bash
exit

从文件复制镜像/Chart 到仓库

步骤 1：启动 ImgUtils 环境

bash
# Docker 本地环境
docker run --name imgutils --rm -ti nmaguiar/imgutils sudo /bin/bash

# Kubernetes 集群环境
kubectl run imgutils --rm -ti --image=nmaguiar/imgutils -- sudo /bin/bash

步骤 2：将本地文件复制到容器内

Docker 环境：

bash
docker cp myImageOrChart.tgz imgutils:/tmp/myImageOrChart.tgz

Kubernetes 环境：

bash
kubectl cp myImageOrChart.tgz imgutils:/tmp/myImageOrChart.tgz

步骤 3：登录目标仓库

bash
# 登录目标仓库 B（Helm Chart 需额外登录 Helm 仓库）
skopeo login b.registry -u userB --password-stdin
[输入 userB 密码后按 Ctrl+D 确认]

helm registry login b.registry -u userB --password-stdin
[输入 userB 密码后按 Ctrl+D 确认]

步骤 4：复制到仓库

复制镜像文件：

bash
skopeo copy --all docker-archive:/tmp/myImage.tgz docker://b.registry/some/image:1.2.3

复制 Helm Chart 文件：

bash
helm push /tmp/myChart.tgz oci://b.registry/some/chart

步骤 5：退出环境

bash
exit

访问 Docker 守护进程

通过挂载 Docker 套接字直接与本地 Docker 守护进程交互：

启动容器

bash
docker run --rm -ti -v /var/run/docker.sock:/var/run/docker.sock nmaguiar/imgutils sudo /bin/bash

常用操作示例

bash
# 查看本地镜像
docker images

# 查看运行中容器
docker ps

# 删除镜像
docker rmi some/image:latest

退出环境

bash
exit

访问 Kubernetes 容器运行时

通过 crictl 工具与节点上的容器运行时（containerd/crio）交互，以下为不同环境示例：

AWS EKS 环境（containerd）

bash
NODENAME=k3s-server-0 NAME=imgutils HPATH=/run/containerd/containerd.sock  /bin/sh -c 'kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils\",\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/containerd/containerd.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/containerd/containerd.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

K3S 环境（containerd）

bash
NODENAME=k3s-server-0 NAME=imgutils HPATH=/run/k3s/containerd/containerd.sock  /bin/sh -c 'kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils\",\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/containerd/containerd.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/containerd/containerd.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

OpenShift 环境（crio）

bash
NODENAME=server-0 NAME=imgutils HPATH=/var/run/crio/crio.sock  /bin/sh -c './kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils\",\"securityContext\":{\"privileged\":true},\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/crio/crio.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 imgutils 镜像标签

docker pull docker.xuanyuan.run/nmaguiar/imgutils:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull nmaguiar/imgutils:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

nmaguiar/imgutils

nmaguiar

集成docker、helm、skopeo、dive、crictl工具的容器镜像，用于容器开发、运维及镜像管理操作。

1 次收藏下载次数: 0状态：社区镜像维护者：nmaguiar仓库类型：镜像最近更新：28 天前

让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

镜像标签列表与下载命令

ImgUtils Docker镜像文档

镜像概述和主要用途

同时提供精简版本 nmaguiar/imgutils:lite，仅包含核心工具 crictl，适用于仅需容器运行时交互的场景。

核心功能和特性

集成工具集

skopeo：跨容器仓库镜像复制、检查和管理工具
helm：Kubernetes 包管理器，支持 Helm Chart 管理和 OCI 仓库交互
docker-cli：Docker 命令行工具，用于与 Docker 守护进程交互
crictl：Kubernetes CRI (容器运行时接口) 命令行工具，支持与 containerd/crio 等运行时交互
dive：镜像层分析工具，可视化展示镜像分层结构和内容
openaf：集成 DockerRegistry、Kube、oafp 模块的自动化工具
mc (Midnight Commander)：终端文件管理器，用于镜像内容浏览

使用场景和适用范围

适用场景

跨容器仓库（如私有仓库、公共仓库）的镜像/Helm Chart 复制与同步
Kubernetes 集群内节点级容器运行时（containerd/crio）的直接访问与管理
镜像内容检查、分层分析及安全审计
Docker 守护进程本地或远程访问（需挂载 Docker 套接字）

支持环境

Kubernetes 发行版：AWS EKS、K3S/K3D、OpenShift
容器运行时：containerd、crio
部署方式：Docker 本地运行、Kubernetes 集群内临时 Pod 部署

镜像安全扫描

版本信息

!https://raw.githubusercontent.com/nmaguiar/imgutils/main/.github/build-versions.svg
!https://raw.githubusercontent.com/nmaguiar/imgutils/main/.github/latest-versions.svg

使用方法和配置说明

环境变量说明

环境变量	说明	默认值
`CONTAINER_RUNTIME_ENDPOINT`	容器运行时接口端点（供 crictl 使用）	`unix:///run/containerd/containerd.sock`

1. 完整版镜像（nmaguiar/imgutils）

Docker 本地运行

直接通过 Docker 运行，挂载 Docker 套接字以访问本地 Docker 守护进程：

bash
docker run --rm -ti -v /var/run/docker.sock:/var/run/docker.sock nmaguiar/imgutils sudo /bin/bash

Kubernetes 集群内运行

需通过 kubectl run 在目标节点部署临时 Pod，以下为不同 Kubernetes 环境的部署命令：

前提条件

已获取目标节点名称（通过 kubectl get nodes 查看）
集群已配置适当权限（如 kube-system 命名空间访问权限）

AWS EKS 环境

bash
NODENAME=ec2-server-0 NAME=imgutils HPATH=/run/containerd/containerd.sock  /bin/sh -c 'kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils\",\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/containerd/containerd.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/containerd/containerd.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

K3S/K3D 环境

bash
NODENAME=k3s-server-0 NAME=imgutils HPATH=/run/k3s/containerd/containerd.sock  /bin/sh -c 'kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils\",\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/containerd/containerd.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/containerd/containerd.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

OpenShift 环境

bash
NODENAME=server-0 NAME=imgutils HPATH=/var/run/crio/crio.sock  /bin/sh -c './kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils\",\"securityContext\":{\"privileged\":true},\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/crio/crio.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/crio/crio.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

参数说明：

NODENAME：目标节点名称（需替换为实际节点名）
NAME：临时 Pod 名称（自定义，如 imgutils）
HPATH：容器运行时套接字路径（根据环境调整，如 containerd 为 /run/containerd/containerd.sock）

2. 精简版镜像（nmaguiar/imgutils:lite）

仅包含 crictl 工具，适用于轻量级容器运行时交互，部署命令与完整版类似，仅需将镜像标签改为 :lite：

AWS EKS 环境

bash
NODENAME=ec2-server-0 NAME=imgutils HPATH=/run/containerd/containerd.sock  /bin/sh -c 'kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils:lite\",\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/containerd/containerd.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/containerd/containerd.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

K3S/K3D 环境

bash
NODENAME=k3s-server-0 NAME=imgutils HPATH=/run/k3s/containerd/containerd.sock  /bin/sh -c 'kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils:lite\",\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/containerd/containerd.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/containerd/containerd.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

OpenShift 环境

bash
NODENAME=server-0 NAME=imgutils HPATH=/var/run/crio/crio.sock  /bin/sh -c './kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils:lite\",\"securityContext\":{\"privileged\":true},\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/crio/crio.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/crio/crio.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

操作指南

镜像和 Helm Chart 在仓库间复制

步骤 1：启动 ImgUtils 环境

bash
# Docker 本地环境
docker run --rm -ti nmaguiar/imgutils sudo /bin/bash

# Kubernetes 集群环境
kubectl run imgutils --rm -ti --image=nmaguiar/imgutils -- sudo /bin/bash

步骤 2：登录源仓库和目标仓库

使用 skopeo login 登录两个仓库（支持 --password-stdin 避免明文密码输入）：

bash
# 登录源仓库 A
skopeo login a.registry -u userA --password-stdin
[输入 userA 密码后按 Ctrl+D 确认]

# 登录目标仓库 B
skopeo login b.registry -u userB --password-stdin
[输入 userB 密码后按 Ctrl+D 确认]

步骤 3：复制镜像或 Helm Chart

复制镜像（--all 保留所有平台架构）：

bash
skopeo copy --all docker://a.registry/some/image:1.2.3 docker://b.registry/some/image:1.2.3

复制 Helm Chart（Helm Chart 通常以 OCI 镜像形式存储）：

bash
skopeo copy --all docker://a.registry/some/chart:1.2.3 docker://b.registry/some/chart:1.2.3

步骤 4：退出环境

bash
exit

从文件复制镜像/Chart 到仓库

步骤 1：启动 ImgUtils 环境

bash
# Docker 本地环境
docker run --name imgutils --rm -ti nmaguiar/imgutils sudo /bin/bash

# Kubernetes 集群环境
kubectl run imgutils --rm -ti --image=nmaguiar/imgutils -- sudo /bin/bash

步骤 2：将本地文件复制到容器内

Docker 环境：

bash
docker cp myImageOrChart.tgz imgutils:/tmp/myImageOrChart.tgz

Kubernetes 环境：

bash
kubectl cp myImageOrChart.tgz imgutils:/tmp/myImageOrChart.tgz

步骤 3：登录目标仓库

bash
# 登录目标仓库 B（Helm Chart 需额外登录 Helm 仓库）
skopeo login b.registry -u userB --password-stdin
[输入 userB 密码后按 Ctrl+D 确认]

helm registry login b.registry -u userB --password-stdin
[输入 userB 密码后按 Ctrl+D 确认]

步骤 4：复制到仓库

复制镜像文件：

bash
skopeo copy --all docker-archive:/tmp/myImage.tgz docker://b.registry/some/image:1.2.3

复制 Helm Chart 文件：

bash
helm push /tmp/myChart.tgz oci://b.registry/some/chart

步骤 5：退出环境

bash
exit

访问 Docker 守护进程

通过挂载 Docker 套接字直接与本地 Docker 守护进程交互：

启动容器

bash
docker run --rm -ti -v /var/run/docker.sock:/var/run/docker.sock nmaguiar/imgutils sudo /bin/bash

常用操作示例

bash
# 查看本地镜像
docker images

# 查看运行中容器
docker ps

# 删除镜像
docker rmi some/image:latest

退出环境

bash
exit

访问 Kubernetes 容器运行时

通过 crictl 工具与节点上的容器运行时（containerd/crio）交互，以下为不同环境示例：

AWS EKS 环境（containerd）

bash
NODENAME=k3s-server-0 NAME=imgutils HPATH=/run/containerd/containerd.sock  /bin/sh -c 'kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils\",\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/containerd/containerd.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/containerd/containerd.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

K3S 环境（containerd）

bash
NODENAME=k3s-server-0 NAME=imgutils HPATH=/run/k3s/containerd/containerd.sock  /bin/sh -c 'kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils\",\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/containerd/containerd.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"mountPath\":\"/run/containerd/containerd.sock\"}]}],\"volumes\":[{\"name\":\"cri\",\"hostPath\":{\"path\":\"$HPATH\"}}]}}" -- sudo -E /bin/bash'

OpenShift 环境（crio）

bash
NODENAME=server-0 NAME=imgutils HPATH=/var/run/crio/crio.sock  /bin/sh -c './kubectl run -n kube-system $NAME --rm -ti --image=nmaguiar/imgutils  --overrides="{\"apiVersion\":\"v1\",\"spec\":{\"nodeName\":\"$NODENAME\",\"containers\":[{\"name\":\"$NAME\",\"image\":\"nmaguiar/imgutils\",\"securityContext\":{\"privileged\":true},\"stdin\":true,\"stdinOnce\":true,\"tty\":true,\"args\":[\"sudo\",\"-E\",\"/bin/bash\"],\"env\":[{\"name\":\"CONTAINER_RUNTIME_ENDPOINT\",\"value\":\"unix:///run/crio/crio.sock\"}],\"volumeMounts\":[{\"name\":\"cri\",\"

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 imgutils 镜像标签

docker pull docker.xuanyuan.run/nmaguiar/imgutils:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull nmaguiar/imgutils:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"