故障排查
找到你看到的症状或错误信息，然后按照其下方的方法处理。网络问题请参阅网络。
vphone-vm 在虚拟机打开前被终止
-
运行宿主机预检：
CLI 不带授权，因此它会继续运行，并能说明 AMFI 为何拒绝与它配套的已签名
vphone-vm。 -
如果你重新构建了 bundle，cdhash 就会改变。请按照宿主机设置中的说明，用 bundle 自带的辅助程序允许新的二进制文件。
Virtualization is not available on this hardware
PV=3 客户机不能嵌套运行。请在 Apple Silicon Mac 上直接启动，而不是在另一个 macOS 虚拟机中。
vm create 打印了 vphoned 成功信息，但没有虚拟机在运行
这是正常的。创建流程会临时以图形界面启动一次，发送一次真实的 ping，并在返回前停止这次启动。要使用虚拟机，请启动它：
停在“Press home to continue”
点击虚拟机窗口标题栏中的主屏幕按钮。当前的 JB 流程不会安装 VNC 服务器。
App 因 EXC_GUARD / GUARD_TYPE_MACH_PORT 退出
内核补丁 kernel-boot-thread_guard_violation 会阻止致命的 Mach 端口守卫投递。它只适用于 iOS 18 基础系统，因为在这类系统上启动需要它，所有预设都会在这类系统上开启它。其他基础系统无法选择这个补丁，因此在 26.x 基础系统上触发这个守卫的 App 仍会退出。见 issue #291。
恢复或首次启动失败
- 在手动流程中，让虚拟机保持在 DFU 模式，直到
restore退出。 - 确认在线票据请求能够访问 Apple。
- 对于完整流程，请用一个新名称并加上
-v重新运行vm create，以获取工具的详细输出。 - 内存或磁盘紧张时，避免同时创建多台虚拟机。
- 把 iPhone IPSW 与 PCC 映像组合使用之前，请查看固件兼容性。
客户机已启动，但 vphoned 在创建期间没有响应
首次启动检查会在 300 秒后超时。创建流程使用图形界面启动，因为新恢复的客户机在首次无界面启动时可能不会启动 vphoned。成功标记能证明什么，请参阅创建与运行。
Xcode 或 Instruments 把客户机列为离线
CoreDevice 把客户机配对为有线设备，但只在有程序占用隧道时才让它保持连接。没有隧道时，xcrun xctrace list devices 会把客户机列在“Devices Offline”下，xctrace record --device <UDID> 会等待设备启动，约 30 秒后放弃。Instruments 只会提出连接网络设备，不会连接有线设备。
让 vphone-vm 在客户机运行期间保持隧道开启：
-
在虚拟机窗口中选择 Diagnostics > Keep Developer Tunnel Open。设置立即生效，并保存到这台虚拟机。
-
或者在终端中运行：
这会从下次启动起生效。
vm info会以developer tunnel显示这项设置。
vphoned 响应后，vphone-vm 会针对客户机运行 /usr/bin/devicectl，它每次退出都会重新启动。如果 Mac 上没有 /usr/bin/devicectl，虚拟机日志会显示一行 [developer-tunnel]，隧道不会被保持。
不支持这项设置的 bundle 可以改在终端中保持隧道。从 vphone-cli vm info <name> 取得客户机的 UDID，然后让下面的命令一直运行：
--session-timeout 必须小于 --timeout。命令会在一小时后退出，届时再运行一次。
隧道建立后的一分钟左右，xctrace record --attach 可能因 Cannot find process matching name 或 Cannot find process for provided pid 失败。稍等片刻再试。