Docker 从本地Label-studio导入 tar 镜像包

Docker 从本地导入 tar 包为镜像（核心命令+完整步骤）

从本地 tar 包导入 Docker 镜像的核心命令是docker load，搭配-i参数指定本地 tar 包路径即可，操作极简且无需解压缩（直接识别 Docker 镜像归档格式），以下是通用步骤+贴合你 Label Studio 场景的实操示例，命令可直接复制执行。

一、前提：确认本地 tar 包的路径和名称（避免路径错误）

先执行命令查看 tar 包的准确路径（当前目录执行最便捷，若 tar 包在其他目录需写绝对路径）：

# 查看当前目录下的 Label Studio tar 包（示例，可根据实际文件名修改）ls-lh ./label-studio-latest.tar ```bash Last login: Sun Jan2500:04:232026from127.0.0.1[root@VM-0-7-tencentos ~]# cd /www/server/label-studio[root@VM-0-7-tencentos label-studio]# lslabel-studio-latest.tar[root@VM-0-7-tencentos label-studio]# docker locad -i label-studio-latest.tarEmulate Docker CLI using podman. Create /etc/containers/nodocker to quiet msg. Error: unknown shorthand flag:'i'in-i See'podman --help'[root@VM-0-7-tencentos label-studio]# docker load -i label-studio-latest.tarEmulate Docker CLI using podman. Create /etc/containers/nodocker to quiet msg. Getting imagesourcesignatures Copying blob 1733a4cd5954done|Copying blob 7d57262f6487done|Copying blob 913d0e6412c2done|Copying blob 55404cda3ac4done|Copying blob 928ff53ece94done|Copying blob 9501295bf47adone|Copying blob 85158b08abfbdone|Copying blob c4ee2a8567acdone|Copying blob 4483cb92e328done|Copying blob ab016b1378f5done|Copying blob 370ac180036adone|Copying blob 16b40bf3149ddone|Copying blob d31908c29b3ddone|Copying blob 57bf1ab47eb9done|Copying blob 4f94717fa349done|Copying blob be6cce0b6103done|Copying blob fef0d1e46d54done|Copying blob 996179e3196adone|Copying blob cbeffead2cacdone|Copying blob 471a38752558done|Copying blob 37a265a4dc10done|Copying config 6176f78809done|Writing manifest to image destination Loaded image: docker.io/heartexlabs/label-studio:latest[root@VM-0-7-tencentos label-studio]#

若 tar 包在其他目录，直接写绝对路径，例：/root/backup/label-studio.tar

确认输出中能看到对应的 tar 包（非空，有正常文件大小），即可继续下一步。 ### 二、核心步骤：导入本地 tar 包为 Docker 镜像 #### 通用命令格式 ```bash docker load -i 本地tar包的路径/包名.tar

• 关键参数-i：指定「输入文件」，必加参数，用于告诉 Docker 从指定 tar 包读取镜像数据；
• 无需解压缩 tar 包：Docker 会自动识别镜像的分层归档结构，解压缩后反而会破坏镜像结构导致导入失败。

贴合你的 Label Studio 实操示例

情况1：tar 包在当前目录（最常用）

# 导入 Label Studio 镜像 tar 包（替换为你的实际包名）dockerload -i ./label-studio-latest.tar

情况2：tar 包在其他目录（写绝对路径）

# 示例：tar 包在 /root/soft 目录下dockerload -i /root/soft/label-studio-latest.tar

导入成功的典型提示

执行后若看到以下输出，说明镜像导入成功，同时会显示镜像的完整名称+标签：

Loaded image: heartexlabs/label-studio:latest# 若此前是国内源镜像导出的，会显示：Loaded image: registry.cn-hangzhou.aliyuncs.com/heartexlabs/label-studio:latest

三、关键验证：确认镜像已成功导入本地仓库

导入后执行以下命令，查看本地 Docker 镜像列表，确认 Label Studio 镜像存在：

# 过滤出 label-studio 相关镜像，验证导入结果dockerimages|greplabel-studio

预期正常输出（包含镜像名、标签、ID 等信息，非空即成功）：

heartexlabs/label-studio latest xxxxxxxx2weeks ago1.8GB# 或国内源镜像名：# registry.cn-hangzhou.aliyuncs.com/heartexlabs/label-studio latest xxxxxxxx 2 weeks ago 1.8GB

四、导入后直接使用：启动 Label Studio 容器（衔接你的实际需求）

镜像导入成功后，即可直接执行启动命令，挂载数据卷并运行容器，和直接拉取的镜像使用方式完全一致：

# 后台启动容器，映射8080端口，挂载数据卷保存标注数据dockerrun -it -d -p8080:8080 -v$(pwd)/label-studio-data:/label-studio/data heartexlabs/label-studio:latest

• -d：后台运行容器，不占用当前终端（推荐添加）；
• 挂载数据卷：确保标注数据持久化，不会因容器删除丢失。