QEMU虚拟机的正确退出方式与实践指南

1. QEMU退出命令的几种方式

QEMU作为一款功能强大的开源机器模拟器和虚拟化工具，在日常开发测试中扮演着重要角色。但很多新手在使用时常常遇到一个看似简单却实际困扰的问题——如何正确退出QEMU会话。与普通应用程序不同，QEMU作为系统级模拟器需要特定的退出方式，否则可能导致进程残留或数据丢失。

1.1 图形界面下的退出方式

对于带有图形界面的QEMU实例（如使用SDL、GTK等显示后端），最直观的退出方式是：

1. 点击窗口右上角的关闭按钮（X）
2. 使用组合键：Ctrl+Alt+2 切换到QEMU控制台，输入quit命令
3. 对于VNC显示：先断开VNC客户端连接，再在宿主机终止QEMU进程

注意：直接关闭图形窗口可能导致客户机未正常关机，建议先在内部分执行关机命令（如Linux的poweroff或Windows的开始菜单关机）

1.2 无图形界面的控制台退出

在纯命令行模式下运行的QEMU（如通过-nographic参数启动），退出方式有所不同：

1. 标准退出序列：Ctrl+A 松开后按 X
   • 这是QEMU的默认控制台转义序列
   • 会立即终止模拟器，相当于强制关机
2. 安全退出流程：
   • 先按Ctrl+A 松开后按 C 进入QEMU监控器
   • 输入system_powerdown发送ACPI关机信号
   • 等待客户机完成关机流程
   • 最后输入quit退出QEMU

1.3 通过QEMU监控器退出

QEMU监控器是最规范的退出途径，适用于所有运行模式：

1. 进入监控器：
   • 图形模式：Ctrl+Alt+2
   • 控制台模式：Ctrl+A C
2. 监控器命令：
   • quit：立即退出QEMU（强制）
   • system_powerdown：发送关机信号（优雅）
   • stop暂停虚拟机 → quit退出
3. 带状态保存的退出：

   bash复制migrate "exec:gzip -c > vm_state.gz"
   quit
   

2. 不同场景下的退出实践

2.1 安装OpenKylin时的退出问题

在Windows的QEMU上安装OpenKylin这类国产操作系统时，常见以下情况：

1. 安装程序独占输入：
   • 安装过程中QEMU可能捕获所有键盘输入
   • 解决方案：先按Ctrl+Alt+G释放键盘捕获，再尝试退出
2. 安装后无法关机：
   • 某些镜像的ACPI支持不完善
   • 可尝试在监控器执行：

     bash复制sendkey ctrl-alt-delete
     

     触发系统关机流程

2.2 OpenHarmony模拟器中的特殊处理

参考《OpenHarmony 6.1 QEMU模拟器一键搭建指南》，其QEMU封装脚本通常包含自定义退出逻辑：

1. 脚本化退出方案：

   bash复制# 通过PID文件终止
   pkill -F qemu.pid
   

2. 网络配置保存：
   • 退出前执行netdev del移除虚拟网卡
   • 避免下次启动出现"device already in use"错误

2.3 ARM架构下的注意事项

在QEMU上运行ARM架构系统（如麒麟ARM版）时：

1. 某些ARM板型不支持标准ACPI关机：
   • 需要在启动参数添加-no-acpi或
   • 使用板载复位功能：

     bash复制qom-set /machine reset
     

2. 高权限操作要求：
   • 非root用户可能无法正常退出
   • 建议通过sudo kill终止进程

3. 异常退出处理与调试

3.1 检测QEMU僵尸进程

异常退出后需要检查：

bash复制ps aux | grep qemu

若发现残留进程，应：

bash复制kill -9 <PID>

并检查/var/run/libvirt/qemu/下的残留文件

3.2 常见错误代码解析

3.3 日志分析技巧

启用详细日志有助于诊断退出问题：

bash复制qemu-system-x86_64 -d help  # 查看日志选项
qemu-system-x86_64 -d trace:vmstate  # 跟踪状态保存

关键日志位置：

• /var/log/libvirt/qemu/
• ~/.cache/qemu/

4. 自动化脚本中的退出管理

4.1 使用expect实现自动退出

bash复制#!/usr/bin/expect
spawn qemu-system-x86_64 -hda vm.img
expect "login:" {send "root\r"}
expect "Password:" {send "123456\r"}
expect "#" {send "poweroff\r"}
expect "Power down" {send "ctrl+a c\r"}
expect "(qemu)" {send "quit\r"}

4.2 systemd单元文件示例

创建/etc/systemd/system/qemu-vm.service：

ini复制[Unit]
Description=QEMU VM

[Service]
ExecStart=/usr/bin/qemu-system-x86_64 -daemonize -name vm1
ExecStop=/usr/bin/qemu-monitor --cmd quit
TimeoutStopSec=30
KillMode=process

[Install]
WantedBy=multi-user.target

4.3 资源清理脚本

bash复制#!/bin/bash
# 清理QEMU残留资源
virsh list --all | grep "shut off" | awk '{print $2}' | xargs -I {} virsh undefine {}
rm -f /var/lock/qemu-*
ip link del virbr0 2>/dev/null

在实际使用中，我发现很多异常退出问题源于对QEMU运行模式的理解不足。例如在无图形模式误用GUI退出方式，或在ARM架构忽略板型特殊性。建议根据具体场景建立标准退出流程，并在自动化脚本中加入超时检测和资源回收机制。对于生产环境，最好通过libvirt等管理工具间接操作QEMU，能显著提高稳定性。