跳到主要内容

系统初始化原理

从模板克隆虚拟机时，QVMConsole 会根据不同操作系统类型自动执行离线初始化，在虚拟机首次启动前完成主机名、用户账号、密码等配置注入，实现开箱即用。

初始化流程总览​

离线初始化的优势

QVMConsole 的初始化完全在离线阶段（虚拟机启动前）通过 virt-customize 和 guestfish 工具完成，无需 SSH 连接虚拟机，也不依赖虚拟机网络状态，可靠性极高。OpenWrt 因使用 BusyBox、缺少 setarch 等工具，所有修改仅通过文件注入完成，不使用 --run-command。

Linux 系统初始化（cloud-init NoCloud）​

Linux 虚拟机的初始化采用 cloud-init NoCloud 数据源方式，是目前云环境中最成熟的初始化方案。

初始化流程​

关键步骤详解​

1. 身份重置​

克隆后的虚拟机与模板共享相同的 machine-id，这会导致 DHCP 服务器分配相同的 IP 地址。系统通过以下命令清理身份信息：

# 清空 machine-id
truncate -s 0 /etc/machine-id
rm -f /var/lib/dbus/machine-id

# 清理 DHCP 租约
rm -f /var/lib/dhcp/*.leases
rm -f /var/lib/NetworkManager/*.lease
rm -f /var/lib/systemd/network/*.lease

2. cloud-init 配置清理​

许多 Linux 发行版的安装器（如 Ubuntu 的 subiquity/curtin）会在安装后写入特殊配置文件，这些配置会干扰克隆后的初始化：

# 删除安装器遗留配置（强制恢复 NoCloud 数据源）
rm -f /etc/cloud/cloud.cfg.d/99-installer.cfg
rm -f /etc/cloud/cloud.cfg.d/00-subiquity-disable-cloudinit-networking.cfg
rm -f /etc/cloud/cloud.cfg.d/curtin-preserve-sources.cfg

# 清理实例缓存（强制重新初始化）
rm -rf /var/lib/cloud/instances/* /var/lib/cloud/instance

# 启用 cloud-init
rm -f /etc/cloud/cloud-init.disabled

3. NoCloud Seed 文件注入​

系统将 cloud-init 配置文件注入到 /var/lib/cloud/seed/nocloud/ 目录：

meta-data 文件：

instance-id: iid-<vm_name>-<timestamp>
local-hostname: <hostname>

user-data 文件：

#cloud-config
hostname: <hostname>
manage_etc_hosts: true
ssh_pwauth: true

growpart:
  mode: auto
  devices: ['/']
resize_rootfs: true

runcmd:
  - hostnamectl set-hostname <hostname>
  # LVM 感知磁盘扩容脚本
  - |
    set +e
    ROOT_DEV=$(findmnt -n -o SOURCE /)
    # 自动检测 LVM 并执行 pvresize + lvextend
    ...
LVM 自动扩容

user-data 中内置了 LVM 感知的磁盘扩容脚本。当克隆时指定了更大的磁盘大小，系统会在首次启动时自动检测根分区是否为 LVM，并执行 pvresize + lvextend -r -l +100%FREE 完成扩容。

网络兼容性兜底

离线阶段还会对网络配置做兼容性处理：清理 netplan 中绑定的旧 MAC 地址（避免克隆后网卡无法匹配），并为 systemd-networkd 预置 DHCP 热插拔兜底配置，确保克隆后的虚拟机能够通过 DHCP 重新获取地址。阻塞式启动后命令（post_boot_command）会被安装为 Before=sshd 的 systemd oneshot 服务，保证在 SSH 可用前执行完毕。

4. 密码和用户名处理​

密码修改通过 virt-customize --password 直接修改 /etc/shadow，无需 SSH 连接：

# 设置 root 密码
virt-customize -a <disk> --password root:password:<password>

# 设置模板用户密码
virt-customize -a <disk> --password <template_user>:password:<password>

用户名重命名通过 usermod 在离线阶段完成：

# 重命名用户
usermod -l <new_user> <template_user>
usermod -d /home/<new_user> -m <new_user>
groupmod -n <new_user> <template_user>

Windows 系统初始化（CloudbaseInit + ConfigDrive）​

Windows 虚拟机的初始化采用 CloudbaseInit 配合 ConfigDrive 元数据方式，是 Windows 云环境的标准初始化方案。

初始化流程​

CloudbaseInit 配置​

系统注入的 cloudbase-init.conf 配置了以下关键参数：

配置项值说明
metadata_servicesConfigDriveService使用 ConfigDrive 作为元数据源
pluginsSetHostName, SetUserPassword, ExtendVolumes 等启用的初始化插件列表
inject_user_passwordtrue允许注入用户密码
config_drive_cdromtrue从 CD-ROM 读取 ConfigDrive

Unattend.xml 配置​

系统为 Windows 生成 Unattend.xml 跳过 OOBE 向导，实现无人值守初始化：

  • specialize 阶段：禁用 AutoLogon、设置临时密码防止无密码登录
  • oobeSystem 阶段：跳过 EULA、网络位置选择、隐私设置等向导页面
Windows Server 2025 / Windows 11 特殊处理

这两个版本需要在 oobeSystem 阶段额外配置 UserAccounts/AdministratorPassword 和 AutoLogon(LogonCount=1) 才能跳过密码设置屏幕。

Config Drive ISO 创建​

系统创建一个符合 OpenStack 规范、卷标为 config-2 的 ISO 文件作为 ConfigDrive 元数据：

/openstack/
  latest/
    meta_data.json    # 包含 uuid、name、hostname、admin_pass、admin_username
    user_data         # PowerShell 脚本：清除"登录前必须改密"标志等

ISO 生成工具按 genisoimage → xorriso → mkisofs 的顺序自动探测可用工具。x86_64 虚拟机以 SATA CD-ROM 方式挂载；aarch64（ARM64）虚拟机强制使用 USB 总线 CD-ROM，以兼容 ARM 平台的固件行为。

自动弹出机制​

Config Drive ISO 在虚拟机启动后通过 QEMU Guest Agent 轮询 cloudbase-init 日志，当检测到 Plugins execution done 执行完成标记后自动弹出 CD-ROM 并清理 ISO 文件，避免残留光驱设备。

NTFS 分区检测​

注入配置文件前，系统通过 guestfish 检测磁盘中的 Windows NTFS 系统分区：

  1. 使用 guestfish list-filesystems 列出所有文件系统
  2. 筛选 NTFS 分区
  3. 在每个 NTFS 分区中查找 /Windows 目录
  4. 找到含 /Windows 的分区即为系统分区
Windows Server 2025 兼容性

virt-customize 的 OS 自动检测在 Windows Server 2025 上可能失败（已知问题），系统会自动回退为 guestfish 显式挂载 NTFS 分区方式绕过此问题。

OpenWrt 系统初始化​

OpenWrt（含 iStoreOS 等衍生版）使用 BusyBox 环境，缺少 setarch 等工具，因此初始化只通过文件注入完成，不使用 virt-customize --run-command。克隆 OpenWrt 模板时必须提供静态 IP、网关与 DNS 配置。

磁盘布局检测​

系统首先检测模板磁盘的根分区布局，自动选择注入方式：

两种注入方式​

布局注入方式说明
ext4（标准 OpenWrt）virt-customize --upload直接写入 /etc/config/network、/etc/config/system、/etc/shadow 等配置文件
squashfs + overlay（如 iStoreOS）guestfish 挂载 overlay upper 分区写入将配置写入 overlay 的 upper 目录，效果等同于首次启动后的配置修改

UCI 配置生成​

系统根据克隆表单生成 UCI 风格网络配置：

  • LAN 接口：写入静态 IP、网关、DNS（/etc/config/network）
  • 主机名：写入 /etc/config/system
  • 密码：通过 --password 注入 /etc/shadow
静态 IP 必填

OpenWrt 模板克隆要求明确传入静态 IP/网关/DNS（CIDR 掩码 1-32），否则无法完成网络初始化。

FnOS 系统初始化​

FnOS（飞牛 OS）的初始化通过 virt-customize 直接修改系统文件完成，不依赖 cloud-init。

初始化步骤​

步骤操作说明
1创建/更新用户将用户加入 Users 和 Administrators 组
2设置密码通过 chpasswd 命令设置用户密码
3设置主机名写入 /etc/hostname 和更新 /etc/hosts
4标记系统已初始化写入 system_inited_timestamp 文件
5重置设备身份清理 machine-id 和 device_id
6清理 DHCP 租约防止 IP 地址冲突

设备 ID 管理​

FnOS 使用 32 位十六进制字符串作为设备标识（Device ID），系统支持三种设备 ID 策略：

策略说明
自动重置（默认）清空 machine-id，每次克隆生成新身份
保留原始 ID从模板继承 machine-id 和 device_id
自定义 ID用户指定 32 位或 40 位十六进制设备 ID
设备 ID 保护

自定义设备 ID 写入后会被设置为不可变属性（chattr +i），防止运行时被意外修改。

启动类型检测​

系统在克隆时会自动检测并匹配正确的启动方式（BIOS 或 UEFI）。

检测逻辑​

UEFI 启动支持​

当检测到模板使用 UEFI 启动时，克隆过程会：

  1. 复制 OVMF NVRAM 变量文件作为虚拟机专属的 UEFI 变量存储
  2. 在虚拟机 XML 中配置 loader 和 nvram 元素
  3. 启用 SMM（System Management Mode）和 TPM 模拟器（安全引导场景）

各类型初始化对比​

特性LinuxWindowsOpenWrtFnOSOther
初始化工具virt-customizevirt-customize + guestfishvirt-customize / guestfish（仅文件注入）virt-customize无
主机名设置cloud-init + 离线写入CloudbaseInitUCI system 配置注入离线写入无
密码注入virt-customize --passwordCloudbaseInit + ConfigDrive/etc/shadow 注入chpasswd无
用户名重命名usermod（离线）N/A（使用 Administrator）N/Auseradd/usermod无
磁盘扩容cloud-init growpart + LVM 脚本CloudbaseInit ExtendVolumes无无无
身份重置清理 machine-id + DHCP重置 instance-id无清理 machine-id / 设备 ID 策略无
网络初始化cloud-init 清理租约 + netplan/networkd 兜底DHCP 自动获取静态 IP/网关/DNS UCI 注入清理租约无
首次启动依赖cloud-init 服务CloudbaseInit 服务无（离线完成）无（离线完成）无

相关文档​