qemu-guest-agent 在爱快（虚拟机环境）内部运行 qemu-ga，用于让基于 QEMU/KVM 的虚拟化宿主与爱快虚拟机通信，适用平台：
- Proxmox VE / PVE
- 原生 QEMU/KVM
- 基于 libvirt 的 KVM 虚拟化环境
不适用平台：
- VMware ESXi / Workstation / Fusion：请使用
open-vm-tools插件。 - Hyper-V：QEMU Guest Agent 不适用于 Hyper-V 集成服务。
启用后，宿主侧可以通过 Guest Agent 获取或触发以下能力：
- Guest ping 存活检测
- 读取虚拟机系统信息
- 读取虚拟机网卡与 IP 地址
- 宿主侧触发优雅关机 / 重启
- 文件系统 freeze / thaw，用于配合快照、备份一致性
注意：具体可用能力取决于宿主平台是否开放相应 Guest Agent 命令，以及虚拟机侧 virtio-serial 通道是否正常。
PVE/QEMU/KVM 在虚拟机中提供一个 virtio-serial 通道，常见设备路径为：
/dev/virtio-ports/org.qemu.guest_agent.0
/dev/vport0p1
/dev/vport1p1
/dev/vport2p1
/dev/vport3p1
插件启动后会：
1）加载自带 musl 运行时与 qemu-ga组件
2）自动探测 Guest Agent 通道；也可通过配置指定路径
3）以 daemon 模式启动 qemu-ga，并写入 pidfile
4）将运行日志写入插件日志目录。
插件包内自带 qemu-ga 与依赖库，不依赖爱快系统自带 libc 或发行版包管理器。
宿主侧启用 QEMU Guest Agent，以 PVE 为例：
1）关闭虚拟机。
2）进入虚拟机配置页面。
3）打开：选项 → QEMU Guest Agent → 启用
4）重新启动 iKuai 虚拟机
也可以通过 PVE CLI 配置：
qm set <VMID> --agent enabled=1
qm reboot <VMID>前往 iKuai WebUI，访问插件市场，选择 QEMU Guest Agent 的应用配置
默认值：auto
含义：Guest Agent 通道设备路径。
建议保持 auto，插件会自动探测常见路径。只有在宿主平台使用非标准路径时才需要手动指定，例如：
/dev/virtio-ports/org.qemu.guest_agent.0
默认值：virtio-serial
含义：qemu-ga 通信方式。通常不需要修改。
默认值：空
含义：附加传给 qemu-ga 的参数。普通用户不需要配置。
默认值：0
含义：是否开启详细日志。
0：关闭详细日志1：开启详细日志
排障时可临时改为 1。
在 PVE 宿主执行：
qm agent <VMID> get-osinfo
qm agent <VMID> network-get-interfaces预期：
get-osinfo能返回 guest 信息。network-get-interfaces能返回网卡与 IP 信息。