virt-install 导入既有磁盘
已有磁盘镜像可以跳过安装流程直接创建域：virt-install 加 --import 表示不执行安装，仅按给定的磁盘与引导方式启动。它常用于镜像验收、迁移预演，以及把手工作好的磁盘接入 libvirt 统一管理。
基本信息
| 关键参数 | --import 直接引导既有磁盘 |
|---|---|
| 磁盘参数 | path=...,bus=virtio，需与镜像内驱动匹配 |
| 无图形模式 | --graphics none --console pty,target_type=serial |
| 机型与固件 | --machine 与 --boot uefi 按镜像引导方式选择 |
| 校验方式 | 启动后用 virsh dominfo 与 console 核对 |
| 常见前提 | 镜像内已包含引导装载程序与 virtio 驱动 |
典型使用场景
- 验收第三方或自制的镜像能否正常启动
- 迁移预演：先在本机验证磁盘可用
- 把历史遗留磁盘接入 libvirt 统一管理
- 与 cloud-init 配合做自动化装机验证
- 快速复现用户报告的问题环境
导入现有 qcow2 并串口控制台启动
导入现有 qcow2 并串口控制台启动
virt-install --name legacy01 --memory 2048 --vcpus 2 --import \
--disk path=/data/images/legacy.qcow2,bus=virtio \
--network network=default,model=virtio \
--graphics none --console pty,target_type=serial --osinfo detect=on
virsh dominfo legacy01 # 核对域状态与配置
virsh console legacy01 # 通过串口控制台观察启动过程常见参数
| 参数 | 作用 | 注意点 |
|---|---|---|
| --import | 跳过安装，直接引导磁盘 | 镜像必须自带引导装载程序 |
| --disk | 指定磁盘与总线类型 | 总线型号要与镜像内驱动匹配 |
| --graphics none | 不提供图形界面 | 需要同时配置串口控制台 |
| --osinfo detect=on | 自动识别客户机系统 | 识别错误会影响默认设备选择 |
导入的是既有磁盘，所以“起不来”通常只有三类原因：引导方式（BIOS 与 UEFI）不符、磁盘总线与镜像内驱动不匹配、镜像本身没有引导程序。按这三条依次排查最快，比反复改参数高效得多。
用 --import 指向生产磁盘做实验前先复制一份：域一旦启动就会写入磁盘，误改的代价是数据层面的，不是配置层面的。