红帽全球峰会21.4. guestfish Shell
guestfish 是一个交互式 shell，您可以通过命令行或从 shell 脚本使用以访问 guest 虚拟机文件系统。libguestfs API 的所有功能均可从 shell 访问。
要开始查看或编辑虚拟机磁盘镜像，请输入以下命令，将路径替换为您预期的磁盘镜像：
guestfish --ro -a /path/to/disk/image
$ guestfish --ro -a /path/to/disk/image
--ro 表示磁盘镜像以只读方式打开。这个模式总是安全，但不允许写入访问。仅在 确定 客户机虚拟机没有运行时省略这个选项，或者磁盘镜像没有附加到实时客户机虚拟机。无法使用 libguestfs 编辑实时客户机虚拟机，并尝试使磁盘不可逆损坏。
/path/to/disk/image 是到磁盘的路径。这可以是文件、主机物理机器逻辑卷（如 /dev/VG/LV）或 SAN LUN(/dev/sdf3)。
注意
libguestfs 和 guestfish 不需要 root 权限。当被访问的磁盘镜像需要 root 用户进行读取或写入时，您只需要以 root 用户身份运行它们。
当您以交互方式启动 guestfish 时，它将显示此提示：
在提示符处，键入 run 来启动库并附加磁盘镜像。第一次完成最多可能需要 30 秒。随后的开始将更快地完成。
注意
libguestfs 将使用硬件虚拟化加速（如 KVM（如果可用）来加快这个过程。
输入了 run 命令后，可以使用其他命令，作为以下部分所示。
21.4.1. 使用 guestfish 查看文件系统
复制链接链接已复制到粘贴板!
这部分提供有关使用 guestfish 查看文件系统的信息。
21.4.1.1. 手动列出和查看
复制链接链接已复制到粘贴板!
list-filesystems 命令将列出 libguestfs 找到的文件系统。这个输出显示了 Red Hat Enterprise Linux 4 磁盘镜像：
其他有用的命令包括 list-devices、list-partitions、lvs、pvs、vfs-type 和 file。您可以通过键入 help 命令来获取 更多信息和有关任何命令的帮助，如下例所示：
要查看文件系统的实际内容，必须先挂载它。
您可以使用 ls、ll ll、cat、更多、下载和 tarout 等 guestfish 命令来查看和下载文件和目录。
注意
此 shell 中没有当前工作目录的概念。与一般的 shell 不同，您无法使用 cd 命令来更改目录。所有路径都必须在顶部以正斜杠（）字符开始完全合格。使用 Tab 键完成路径。
要从 guestfish shell 退出，请键入 exit 或按 Ctrl+d。
21.4.1.2. 通过 guestfish 检查
复制链接链接已复制到粘贴板!
guestfish 本身可以检查映像并挂载文件系统，而不是手动列出和挂载文件系统。要做到这一点，在命令行中添加 -i 选项：
由于 guestfish 需要启动 libguestfs 后端才能执行检查和挂载，因此在使用 -i 选项时不需要 run 命令。i 选项 适用于许多常见的 Linux 客户机虚拟机。
21.4.1.3. 按名称访问客户机虚拟机
复制链接链接已复制到粘贴板!
当您指定给 libvirt 的名称时（换句话说，如 virsh list --all所示），可从命令行访问客户机虚拟机。使用 -d 选项按名称或不使用 -i 选项访问客户机虚拟机：
guestfish --ro -d GuestName -i
$ guestfish --ro -d GuestName -i
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}