machinectl 中文手册

列出当前正在运行的虚拟机与容器。 如果要列出可以启动的机器镜像，那么应该使用 list-images 命令(见下文)。 注意，此命令默认不显示例如 ".host" 这样名称以句点开头的机器(可以使用 --all 选项来强制显示)。

显示 当前正在运行的虚拟机与容器的状态信息， 并且在末尾部还会附上几条该机器最新的日志消息。 此命令仅用于输出人类易读的信息， 不要将其用于程序分析(应该使用 show 命令)。 注意， 显示的日志消息来自于虚拟机与容器管理器， 其中通常包含有机器的控制台输出， 且并不必然包含机器自身的日志内容。

如果未指定任何 NAME 参数，那么显示虚拟机与容器管理器自身的属性； 如果指定了至少一个 NAME 参数，那么显示指定的虚拟机与容器的各项属性(必须是已注册的机器)。 注意，默认不显示尚未设置的属性，但是可以通过使用 --all 选项强制显示所有属性。可以使用 --property= 选项限定仅显示指定的属性。 此命令仅用于输出易于程序分析的信息，如果想要输出人类易读的信息， 应该使用 status 命令。

将指定的每个容器都作为一个系统服务启动(通过 systemd-nspawn(1) 工具)。这将会按照指定的机器名称对 systemd-nspawn@.service 进行实例化，然后再像 systemctl start 一样启动所得到的服务单元实例。 systemd-nspawn 将会按照指定的名称在 /var/lib/machines/ 等搜索目录(详见下文)中查找容器镜像并运行它。 可以使用下文的 list-images 命令列出可启动的容器镜像。

注意，因为 systemd-machined.service(8) 不但可以与 systemd-nspawn 通信， 还可以与多种不同的其他虚拟机与容器管理器通信， 所以，同样的， machinectl 的大部分命令 不但可以作用于 systemd-nspawn 管理器， 还可以作用于多种不同的其他虚拟机与容器管理器。 注意，使用此命令启动其他其他虚拟机与容器管理器的虚拟机与容器， 需要配合该管理器的专用工具。

如果想要在命令行上交互式启动一个容器， 并能够完全在容器的控制台上操作，那么必须直接使用 systemd-nspawn 命令。 可以使用 machinectl poweroff 命令关闭运行中的容器。

在宿主机或指定的容器中 开启一个交互式的终端登录会话。 如果指定了 NAME 参数，那么表示连接到指定名称的容器； 如果未指定 NAME 参数或者其值为空字符串或者特殊值 ".host" (见后文)， 那么表示连接到本地宿主机。 这将创建一个连接到宿主机或指定容器的终端(TTY)， 并在其中启动 getty 程序。 注意， 此命令仅适用于将 systemd(1) 用作 init 进程的系统。

此命令将在指定的容器或宿主机上打开一个登录提示符， 并提示输入用户名与密码进行登录。 可以使用下文的 shell 命令、或者带有 --machine= 选项的 systemd-run(1) 命令直接运行一个单独的命令行 (可以在前台交互式运行 也可以在后台非交互式运行)。

在宿主机或指定的容器中 以特定的用户身份运行一个指定的命令。 第一个参数表示连接到哪个机器： 如果指定了 NAME 参数，那么表示连接到指定名称的容器； 如果未指定 NAME 参数或者其值为空字符串或者特殊值".host"(见后文)， 那么表示连接到本地宿主机。 这与 login 命令类似， 但不同之处在于此命令会立即运行 PATH 参数所指定的命令(若未指定则表示启动该用户的默认 shell ， 若该用户没有默认 shell 则启动 /bin/sh 进程)。 USER 的默认值是 "root" 用户，但是可以通过 --uid= 选项或者明确设置 USER 的值来指定其他用户。 可以使用 --setenv= 选项来为被执行的进程设置环境变量。

注意，machinectl shell 并不传递被调用进程的退出状态。 不过 systemd-run 工具可以传递被调用进程的退出状态(见下文)。

如果不带任何参数的使用 shell 命令， 那么将会在本地宿主机上启动一个交互式 shell 会话(默认为 "root" 用户)， 这与启动一个 su(1) 会话很类似，但是不同之处在于， 新启动的 shell 会话与原来的老 shell 会话是完全隔离的， 新老会话不共享任何进程与会话属性，新会话完全处于一个干净的状态， 新会话不带有老会话的任何痕迹。 新会话将会拥有全新的 utmp, login, audit, security and keyring session, ... 并且不会继承 任何老会话中的环境变量与资源限制等各种属性。

设置了 --machine= 选项的 systemd-run(1) 命令 可以用于代替 machinectl shell 命令， 前者具有下列优势：(1)允许非交互式操作；(2)可以更详细的对被调用单元进行底层配置； (3)可以传递被调用进程的运行时状态与退出状态。具体说来就是使用 systemd-run 的 --wait 选项来传递被调用进程的退出状态； 使用 systemd-run 的 --pty 选项来获得一个交互式 shell (与 machinectl shell 类似)。 在实践中，systemd-run 一般用于脚本。 需要注意的是，systemd-run 有可能比 machinectl shell 要求更高的权限。

是否在宿主系统启动的同时 自动使用 systemd-nspawn(1) 将指定的容器作为系统服务来启动。也就是启用/禁用指定的容器所对应的 systemd-nspawn@.service 实例化单元。 这两个命令在效果上与 systemctl enable / systemctl disable 对服务单元的效果相同。

关闭指定的容器。 这将会向指定容器中的 init 进程发送 SIGRTMIN+4 信号， 遵守 systemd 规范的 init 进程将会干净的妥善关闭整个容器。 [提示] stop 是 poweroff 的别名。 注意，对于不遵守 systemd(1) 规范的 init 进程来说(例如 sysvinit)，此命令是无效的。 下文的 terminate 命令可以强制立即关闭一个虚拟机或容器， 但是有可能会造成数据丢失。

重启指定的容器。 这将会向指定容器中的 init 进程发送 SIGINT 信号， 大致上相当于向指定的容器发送 Ctrl+Alt+Del 组合键。 该命令兼容于 所有容器内的各种 init 进程。

强制立即关闭指定的虚拟机或容器，这有可能会造成数据丢失。 此命令强制立即关闭虚拟机或容器的所有进程， 并立即回收指定机器的所有资源。 应该谨慎使用此命令， 建议尽可能使用 poweroff 命令 干净的关闭容器。

向指定的虚拟机或容器内的一个或多个 --kill-who= 进程发送 --signal= 信号。 注意，这里的进程是指在宿主机上看到的进程， 而不是在虚拟机或容器内看到的进程。

将宿主机上的指定路径绑定挂载到指定容器内的指定路径上。NAME 是容器名， SOURCE 是宿主机上的源文件或目录的路径，TARGET 是容器内的目标文件或目录的路径。 如果省略后一个参数，那么表示容器内的目标路径与宿主机上的源路径相同。 如果使用了 --read-only 选项，那么表示以只读的方式绑定挂载。 如果使用了 --mkdir 选项，那么表示自动创建不存在的目标文件或目录。 注意，--mkdir 选项仅可用于 systemd-nspawn(1) 创建的容器，并且仅在未使用 --private-users 选项的情况下才有效。此命令支持绑定挂载 目录、普通文件、设备节点、AF_UNIX 套接字、 管道(FIFO)。

将宿主机上的指定路径(文件或目录)复制到指定容器内的指定路径上。 NAME 是容器名， SOURCE 是宿主机上的某个路径(文件或目录)， TARGET 是指定容器内的某个路径 (省略表示与 SOURCE 相同)。

如果宿主机与容器共享同一个用户名字空间， 那么文件与目录的UID/GID在复制后保持不变， 否则复制后的文件与目录的UID/GID将被统一设为"0"。

将指定容器内的指定路径(文件或目录)复制到宿主机上的指定路径上。 NAME 是容器名， SOURCE 是指定容器内的某个路径(文件或目录)， TARGET 是宿主机上的某个路径 (省略表示与 SOURCE 相同)。

如果宿主机与容器共享同一个用户名字空间， 那么文件与目录的UID/GID在复制后保持不变， 否则复制后的文件与目录的UID/GID将被统一设为"0"。

列出本地已安装的 虚拟机与容器镜像。 这将列出所有搜索目录(例如 /var/lib/machines/ 等，详见后文)中的磁盘镜像、容器根目录或子卷。 可以使用上文的 start 命令启动此命令列出的容器。 注意，除非使用了 --all 选项， 否则此命令不会显示名称以句点(".")开头的容器。 注意，名为 ".host" 的特殊镜像总是隐含存在的， 其含义是宿主机自身的镜像。

显示指定镜像(可以是虚拟机镜像也可以是容器镜像)或者镜像池自身的简洁状态信息。 如果未指定任何 NAME 参数，那么将显示镜像池自身的搜索目录、已用空间、剩余空间。 此命令仅用于输出人类易读的信息， 不要将其用于程序分析(应该使用下面的 show-image 命令)。

显示指定镜像(可以是虚拟机镜像也可以是容器镜像)或者镜像池自身的属性。 如果未指定任何 NAME 参数， 那么将显示镜像池自身的搜索目录、已用空间、剩余空间。 如果明确指定了至少一个 NAME 参数， 那么将显示指定虚拟机或容器的镜像属性。 注意，此命令默认不显示尚未设置的属性，但是可以通过使用 --all 选项强制显示所有属性。可以使用 --property= 选项限定仅显示指定的属性。 此命令仅用于输出易于程序分析的信息，如果想要输出人类易读的信息， 应该使用 image-status 命令。

克隆一个虚拟机或容器镜像。 FROMNAME 表示克隆的源镜像名称，TONAME 表示新创建的克隆镜像名称。 注意，如果底层文件系统支持，那么基于单纯目录树的容器镜像将会优先克隆为 btrfs 子卷。 也就是说，如果底层文件系统支持写时复制(copy-on-write)技术， 那么在克隆时将会自动利用该技术。

注意，因为此命令并不会在克隆过程中修改例如 主机名(hostname), "machine ID" 之类的系统实例标识符， 所以克隆得到的副本镜像将会和源镜像拥有完全相同的系统标识， 在某些情况下， 可能需要手动的修改这些标识符。

如果和 --read-only 选项一起使用， 那么表示创建一个只读的克隆镜像。

将名为 OLDNAME 的虚拟机或容器镜像 重命名为 NEWNAME 。

设置/取消指定虚拟机或容器镜像的只读属性。 NAME 表示镜像的名称， 如果省略 BOOL 参数， 那么相当于设为 yes (设置只读标记)。

从镜像池中删除指定的虚拟机或容器镜像。 注意，不可以删除表示宿主机的、名为 ".host" 的特殊镜像。

为全部或指定的镜像(可以是虚拟机镜像也可以是容器镜像) 设置可占用的最大磁盘空间(以字节为单位)。 如果省略了 NAME 参数， 那么表示设置全部本地虚拟机与容器镜像总计能够占用的最大磁盘空间(以字节为单位)。 如果指定了 NAME 参数， 那么表示仅设置指定的虚拟机或容器镜像可占用的最大磁盘空间(以字节为单位)。 BYTES 参数用于设置最大磁盘空间的尺寸(以字节为单位，可以附加 K, M, G, T 后缀)， 特殊值 "-" 表示取消大小限制。

注意，针对每个容器的磁盘空间限制仅支持 btrfs 文件系统。

删除所有隐藏的虚拟机与容器镜像。也就是删除 /var/lib/machines 目录下所有名称以句点开头的镜像。 可以使用 machinectl list-images --all 命令列出所有镜像(包括隐藏的镜像)。

如果使用了 --all 选项，那么将会删除所有镜像(而不仅仅只是隐藏的镜像)， 这相当于是彻底清空 /var/lib/machines 目录。

注意，例如 machinectl pull-tar 或 machinectl pull-raw 这样的命令，通常都会在克隆已下载镜像的可写入副本(用于常规目的)之前， 首先根据下载的镜像创建一个隐藏的、只读的、原封不动的镜像，以避免在多次使用下载镜像时再次重复下载。 machinectl clean 命令可以用于删除 出于此目的而创建的过时隐藏镜像。

从指定的 URL 下载一个 .tar 格式的容器镜像， 并按照 NAME 名称将其存储在本地镜像池中。 URL 的类型必须是 "http://" 或 "https://" ，并且必须是一个 .tar, .tar.gz, .tar.xz, .tar.bz2 归档文件。如果省略了 NAME 参数， 那么镜像的名称将自动由归档文件的名称中提取 (也就是去掉上述后缀)。

除非明确使用了 --verify=no 选项， 否则将会自动校验下载的镜像文件。 校验操作可以是基于内联的签名文件(与镜像同名并以 .sha256 作为后缀)， 也可以是基于分离的 SHA256SUMS 与 SHA256SUMS.gpg 签名文件。 签名文件必须与镜像文件位于同一个 URL 的同一个目录中。 如果明确指定了 --verify=checksum ， 那么表示仅基于 .sha256 或 SHA256SUMS 文件校验镜像文件的 SHA256 散列值。 如果明确指定了 --verify=signature ， 那么表示基于 .sha256 或 SHA256SUMS.gpg 文件校验镜像文件的 SHA256 散列值。 注意，基于GPG的校验要求所使用的GPG公钥必须已经预先存在于 /usr/lib/systemd/import-pubring.gpg 或 /etc/systemd/import-pubring.gpg 文件中。

容器镜像 将会被下载并保存到 /var/lib/machines/ 目录下的一个只读子卷上， 镜像文件的本地保存名称由 ".tar-" + "镜像的URL" + "HTTP etag" 组成， 随后，将从该子卷上创建一个名为 NAME 的可写快照。 这样就可以高效的根据同一个URL下载的镜像创建多个不同的容器实例， 而不必重复下载同一个镜像。 如果你想只创建只读镜像，而避免创建可写快照， 那么可以将 NAME 参数设为 "-" 。

注意，因为只读子卷的名称带有 .tar- 前缀，所以 list-images 命令必须配合 --all 选项才能显示出来。

注意，在此命令的执行过程中按 Ctrl+C 键并不会中断下载。 要想中断下载， 应该使用下文的 cancel-transfer 命令。

从指定的 URL 下载一个 .raw 格式的容器或虚拟机磁盘镜像， 并按照 NAME 名称将其存储在本地镜像池中。 URL 的类型必须是 "http://" 或 "https://" ，并且必须是一个 .qcow2 或 .raw 格式的磁盘镜像。 磁盘镜像可以是经过压缩的(也就是带有 .gz, .xz, .bz2 后缀)。 如果省略了 NAME 参数， 那么镜像的名称将自动由归档文件的名称中提取 (也就是去掉上述后缀)。

镜像文件的校验规则与上文的 pull-tar 命令完全相同。

如果下载的镜像是 .qcow2 格式， 那么将会被自动转化为 .raw 格式进行存储。

下载的镜像将会以只读 .raw 文件的方式存放在 /var/lib/machines/ 目录中， 镜像文件的本地保存名称由 ".raw-" + "镜像的URL" + "HTTP etag" 组成， 随后，将会自动创建一个名为 NAME 的本地可写入副本。 如果你只想保存只读镜像，而不想创建可写入副本， 那么可以将 NAME 参数设为 "-" 。

注意， 因为只读镜像的名称带有 .raw- 前缀，所以 list-images 命令必须配合 --all 选项才能显示出来。

注意，在此命令的执行过程中按 Ctrl+C 键并不会中断下载。 要想中断下载， 应该使用下文的 cancel-transfer 命令。

从 FILE 文件导入一个 TAR/RAW 格式的虚拟机或容器镜像， 并按照 NAME 名称将其存储在本地镜像池(/var/lib/machines/)中。 对于 import-tar 命令来说， FILE 必须是一个 tar 归档文件(可以经过 xz, gzip, bzip2 压缩)， 此文件将被释放到 /var/lib/machines 目录下一个名为 NAME 的子卷上。 对于 import-raw 命令来说， FILE 必须是一个 qcow2 或者 raw 磁盘镜像(可以经过 xz, gzip, bzip2 压缩)， 此镜像将被释放为 /var/lib/machines 目录下一个名为 NAME.raw 的文件。 如果省略了 NAME 参数，那么其值将自动从 FILE 参数中获取。 如果将 FILE 设置为 "-" ， 那么镜像的内容将从标准输入读取，此时必须明确设置 NAME 参数。

可选地，可以使用 --read-only 选项来创建一个只读的虚拟机或容器镜像。 注意，在导入镜像时，并不会对镜像进行密码验证。

与镜像的下载类似， 既可以使用 list-transfers 命令列出正在导入的镜像， 也可以使用 cancel-transfer 命令取消正在进行中的镜像导入操作。

将本地目录 DIRECTORY 作为容器映像，导入本地镜像池(/var/lib/machines/)中。 所执行的操作与 import-tar 和 import-raw 类似， 不同之处仅在于 DIRECTORY 是一个镜像目录而非镜像文件。 如果系统支持，该命令会为新镜像创建 btrfs 快照或子卷。

导出 名为 NAME 的虚拟机或容器的 TAR/RAW 镜像， 并将其保存为 FILE 文件。 如果 FILE 参数以 ".gz" 结尾，那么将在保存时使用 gzip 压缩。 类似的，以 ".xz" 结尾表示使用 xz 压缩、 以 ".bz2" 结尾表示使用 bzip2 压缩。 不以上述三种压缩格式结尾，则表示不作任何压缩。 省略 FILE 参数表示将镜像的内容输出到标准输出。 可以使用 --format= 选项明确设置压缩格式， 这在省略 FILE 参数时特别有用。

与镜像的下载和导入类似， 既可以使用 list-transfers 命令列出正在导出的镜像， 也可以使用 cancel-transfer 命令取消正在进行中的镜像导出操作。

注意，目前只有目录与子卷的镜像可以导出为 TAR 镜像， 并且目前只有 raw 格式的磁盘镜像可以导出为 RAW 镜像。

列出当前 正在传输(下载、导入、导出)的 虚拟机与容器镜像。

取消指定 ID 编号的 镜像传输(下载、导入、导出)操作。 可以使用上文的 list-transfers 命令列出当前正在传输的镜像所对应的 ID 号。