machinectl import-tar 怎么把压缩容器镜像导入本机

在仍提供该子命令的系统上，machinectl import-tar FILE NAME 可以把本地 TAR 根文件系统归档导入为本机镜像；xz、gzip、bzip2 压缩的 TAR 可以直接作为输入。FILE 是本地归档路径，NAME 是导入后的镜像名，不是目标目录路径。

要先区分工具版本：systemd 255 文档包含 machinectl import-tar；当前 machinectl 文档将镜像导入指向 importctl，新入口可使用 importctl --class=machine import-tar FILE NAME。下面两种配方应按本机实际提供的命令选择。

官方地址：https://www.freedesktop.org/software/systemd/man/latest/machinectl.html

当前导入工具文档：https://www.freedesktop.org/software/systemd/man/latest/importctl.html

最小配方：文件路径和本地名称各占一个参数

假设已准备好 /srv/images/lab-rootfs.tar.xz，要以 lab-rootfs 保存为本地镜像。该路径与名称都是教学占位，请换成实际存在且适用于系统容器的根文件系统包，并选择尚未使用的名称。以下命令未在本文中执行，不表示当前主机已安装或导入该镜像。

# 仅用于本机 machinectl 帮助中仍提供 import-tar 的环境。
# 第一个参数是已有本地 rootfs 压缩包，第二个参数是新镜像名。
sudo machinectl import-tar /srv/images/lab-rootfs.tar.xz lab-rootfs

若系统提供新入口，采用这一条：

# 用于提供 importctl 的环境；machine 类对应容器/虚拟机镜像目录。
# 与上面的旧入口二选一，不要把同一包重复导入同一名称。
sudo importctl --class=machine import-tar /srv/images/lab-rootfs.tar.xz lab-rootfs

这里用 sudo 表达宿主机镜像管理通常需要相应管理权限，不意味着任意普通用户均能直接导入。发行版可能拆分工具和服务包，命令缺失或授权被拒绝应按本机管理规则处理。本文只到镜像导入，不启动容器，也不配置镜像内的服务。

输入是根文件系统 TAR，不是任意后缀为 tar 的文件

import-tar 面向文件系统树归档。导入后保存的是目录树或子卷形式的镜像；machine 类通常放在 /var/lib/machines/。归档应包含操作系统根文件树所需的目录，例如 etc、usr 等，而非只装应用源码的普通压缩包。

Docker save 导出的归档、OCI 镜像布局与这里的根文件系统 TAR 不是可以仅凭扩展名互换的输入。磁盘 RAW 或 qcow2 镜像应使用对应的 import-raw 路径，不要通过重命名为 .tar.xz 来混用。本文不展开其他镜像格式的转换。

名称建议使用简单字母、数字与连字符，不把完整文件名或斜杠路径当作 NAME。虽然省略名称时工具可以从文件名推导，脚本中显式填写通常更容易追踪。名称发生冲突时先确认已有镜像的用途，不把强制覆盖选项作为默认配方。

压缩变体怎么选择

旧 machinectl 配方的官方文档列出 xz、gzip、bzip2；不压缩的 TAR 也属于输入范围。无需为了 xz 文件先手动解压成中间 TAR，再让导入工具解包。当前 importctl 文档还列出 zstd，但不要把这一点推定为所有旧版本和发行版构建都支持。

--format= 在这些文档中用于导出格式选择，不是让 import-tar 接受任意输入格式的开关。用 .xz、.gz 或 .bz2 命名并不能修复实际内容错误；压缩编码与解包出来的文件树都必须符合输入约定。

FILE 写成单个减号表示从标准输入读取，此时必须显式提供 NAME，因为工具无法从文件名推导。普通本地文件场景优先传路径，便于保留输入来源；这里不引入网络下载管道，避免把下载任务和本地导入混为一项。

兼容性先看本机入口

# 这些只读命令帮助读者确认本机工具入口；本文未在主机上执行。
machinectl --version
machinectl --help
# 仅当本机已安装 importctl 时查看其帮助。
importctl --help

不要因最新在线文档有 importctl，就认定本机软件包已经提供它；反过来，也不要因旧教程写了 machinectl import-tar，就给所有新系统拼上旧子命令。发行版可能回移功能，帮助与本机手册比单看版本数字更直接。

当前 importctl 通过 systemd-importd 管理导入。若遇到服务不可用，应检查该发行版是否安装相应组件以及宿主机服务环境是否适用；在不提供这些组件的精简容器里，单独复制一个命令二进制不等于具备整套导入能力。

导入镜像与运行容器是不同对象

# 查看本地已安装镜像，不会启动容器。
machinectl list-images
# 查询该镜像的简要信息，名称应与导入时指定的一致。
machinectl image-status lab-rootfs

读者可用 list-images 查看本地镜像，再用 image-status 查询指定名称。machinectl list 展示的是在线运行实例，导入后没有出现在该列表中并不能单独证明导入失败。反过来，镜像出现在本地列表中，也不保证它一定具备可启动环境或适配宿主机架构。

本地 import-tar 不会自动做归档的密码学来源认证。不要把“导入返回成功”当作“发布者身份与内容完整性已经被证明”。输入应来自你已有的可信镜像准备流程；此处只解释本地导入，不把 pull-tar 的下载验证语义套到 import-tar 上。

常见问题

出现 Unknown command，是压缩包坏了吗？

这类信息首先说明入口或子命令不被识别，还没到解包阶段。先确认本机帮助中应使用 machinectl 还是 importctl，再讨论文件内容。

为什么压缩包很小，导入仍提示空间不足？

目标目录保存的是展开后的文件树，不能只按压缩文件大小估算需求。还应考虑目标文件系统剩余空间、配额和 inode 等实际限制，不能用重复导入代替错误定位。

能用 URL 代替 FILE 吗？

本文的 import-tar 参数是本地文件或标准输入。下载属于 pull-tar 等工具功能的范围，不能把 URL 随手放到本地路径参数里并期待自动下载。

参考资料：systemd 255 machinectl 导入说明、当前 machinectl 镜像管理、当前 importctl 参数与格式。