qemu-guest-agent 与主机内交互

qemu-guest-agent 在 guest 内运行，通过 virtio-serial 通道与宿主交换信息：支持查询接口地址、冻结文件系统、走代理关机与执行命令，是自动化运维的常用通道。

云平台与虚拟化速查云更新于 2026-10-12

通道	XML 中 channel 指向 org.qemu.guest_agent.0
查询信息	virsh qemu-agent-command vm1 '{"execute":"guest-info"}'
接口地址	virsh domifaddr vm1 --source agent
文件系统	virsh domfsinfo vm1（配合静默快照）

验证 agent 通道可用

virsh qemu-agent-command vm1 '{"execute":"guest-info"}' | head
virsh domifaddr vm1 --source agent
virsh domfsfreeze vm1 && virsh domfsthaw vm1   # 冻结/解冻文件系统

易错点

agent 未运行时报 guest agent is not responding：检查服务与通道定义
关机等流程依赖 agent 时未做降级方案：agent 失效要有备用路径

数据来源与参考

libvirt 文档：QEMU guest agent
QEMU 文档：guest agent 协议

继续搜索

常用关键词：3389 traceroute iptables 子网掩码 docker

‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌