【docker】使用regctl免安装docker下载镜像

bluebonnet272026-10-26 8:56

很多时候我们需要在一台没有安装 docker 的设备上下载镜像，尤其是，这是一台Windows设备。不同于 Ubuntu 安装 docker 只需要 sudo apt install docker.io，Windows 的 docker desktop 安装非常费劲。

项目

https://github.com/regclient/regclient

使用方法

可以下载适用于 Windows 的 regctl-windows-amd64.exe，适用于 Linux 的 regctl。

指定镜像源

适用于将原始的 docker hub 地址替换成国内镜像源，这在网速慢或者 hub 被封锁的情况下尤其有用。

以 Windows 替换为毫秒镜像为例：

bash 复制代码

.\regctl-windows-amd64.exe registry set docker.io --mirror https://docker.1ms.run

使用如下命令检查是否替换成功：

bash 复制代码

.\regctl-windows-amd64.exe registry config docker.io

输出类似：

bash 复制代码

{
  "tls": "enabled",
  "hostname": "registry-1.docker.io",
  "credHost": "https://index.docker.io/v1/",
  "mirrors": [
    "https://docker.1ms.run"
  ],
  "reqConcurrent": 3
}

下载镜像为 tar 文件

我们以 AMD Rocm 的 vllm 镜像为例子：

bash 复制代码

.\regctl-windows-amd64.exe image export rocm/vllm:rocm10.0.0_ubuntu24.04_py3.14_pytorch_2.12.0_vllm_0.27.0 rocm10.0.0_ubuntu24.04_py3.14_pytorch_2.12.0_vllm_0.27.0.tar