Debian 13 Cloud 镜像定制与 PVE 模板制作规范

本文档用于规范基于官方 Debian 13 (Trixie) Cloud 镜像的裁剪、调优与模板化流程，解决 Cloud-Init 启动时序竞争、换源被覆盖以及泛化（Sysprep）后的状态重置问题。

阶段一：母机系统调优与 Cloud-Init 防坑加固#

在母机（VM 9000）开机状态下完成基础环境调整与关键配置锁定。

1. 软件源替换与锁定（防止被 Cloud-Init 冲掉）#

Debian 13 默认使用 /etc/apt/mirrors/ 下的列表管理镜像源。为了加速访问同时避免每次初始化被 apt-configure 模块还原为官方默认源，执行以下操作：

1
# 1.1 替换为腾讯云镜像源
2
sudo sed -i 's/deb.debian.org/mirrors.cloud.tencent.com/g' /etc/apt/mirrors/debian.list /etc/apt/mirrors/debian-security.list
3

4
# 1.2 显式告知 Cloud-Init 保留现有 APT 配置，禁止覆盖重写
5
sudo sed -i 's/^[[:space:]]*-[[:space:]]*apt-configure/# - apt-configure/' /etc/cloud/cloud.cfg
6

7
# 1.3 更新源缓存
8
sudo apt update

2. 锁定 systemd 设备依赖（解决光驱识别时序竞争）#

在轻量或极速启动环境下，cloud-init-local 容易在内核完成 /dev/sr0 注册前过早运行，导致探测不到 cidata 卷标而退回 DataSourceNone。通过 systemd drop-in 强制建立启动依赖：

1
# 2.1 强制 cloud-init-local 等待光盘设备单元进入 Active 状态
2
sudo mkdir -p /etc/systemd/system/cloud-init-local.service.d/
3
sudo tee /etc/systemd/system/cloud-init-local.service.d/wait-sr0.conf << 'EOF'
4
[Unit]
5
Requires=dev-sr0.device
6
After=dev-sr0.device
7
EOF
8

9
# 2.2 确保探测器策略不降级
10
sudo tee /etc/cloud/ds-identify.cfg << 'EOF'
11
datasource: NoCloud
12
policy: enabled
13
EOF
14

15
sudo systemctl daemon-reload

3. 安装必备底包与驱动优化#

1
# 安装 PVE 深度集成通信组件
2
sudo apt install -y qemu-guest-agent
3

4
# Debian 13 中该服务由 udev 在 virtio 串口设备出现后自动拉起，
5
# 若未运行可手动启动（通常无需 enable）
6
sudo systemctl start qemu-guest-agent

阶段二：母机离线密封与模板化（Sysprep & Template）#

借助 virt-sysprep 的全量默认清理机制，彻底抹除机器指纹、临时文件、用户历史记录与旧密钥，全权交由子机首次启动时通过 Cloud-Init 重新动态注入。

1. 母机关机#

在母机终端内仅需重置 Cloud-Init 缓存后关机：

1
# 清空 Cloud-Init 本地标记与运行日志，随后关机
2
sudo cloud-init clean --logs --seed
3
sudo poweroff

2. PVE 宿主机执行深度泛化（virt-sysprep）#

在 PVE 宿主机终端执行系统清理。无需指定白名单，直接使用全量默认行为抹除旧 SSH 密钥、machine-id、网卡 MAC、Bash 历史及临时缓存：

1
# 在 PVE 宿主机执行（假设母机磁盘位于 /dev/pve/vm-9000-disk-0）
2
virt-sysprep -a /dev/pve/vm-9000-disk-0

执行前请确认母机已完全关机，避免磁盘仍被 QEMU 占用导致数据损坏。

3. 转换为 PVE 模板#

在 PVE 宿主机执行（或在 Web 控制台右键虚拟机选择“转换为模板”）：

1
qm template 9000

阶段三：日常克隆与使用#

后续需要创建新虚拟机时，使用该模板秒级交付：

创建虚拟机：
- 右键模板 9000 → 克隆 (Clone)。
- 模式选择 链接克隆 (Linked Clone)（秒级建立且节省宿主机存储）。
定义新实例参数：
- 进入子虚拟机的 Cloud-Init 面板：
  - 设置 用户名、密码、SSH 公钥。
  - 配置 IP 配置 (net0) 与 主机名。
- 点击顶部的 “重新生成镜像”。
开机验证：
- 启动虚拟机，Cloud-Init 会在检测到 /dev/sr0 后自动扩充根分区、生成全新 host key、注入公钥并配置网络。
- 使用设置好的 SSH 密钥直接登录测试。

阶段四：子机上线后的优化与剥离（可选）#

克隆出的子机在首次启动成功注入配置后，Cloud-Init 已经完成生命周期任务。为了消除后续每次开机额外的扫描耗时（约 500~800ms），可根据需要对子机进行停用或拔除。

方案 A：就地休眠（推荐：保留自动化反悔能力）#

适合后续可能还希望通过 PVE Web 控制台修改网络 IP 或密码的虚拟机。

在子机内运行：

1
# 写入禁用标志位
2
sudo touch /etc/cloud/cloud-init.disabled

效果：后续开机时，Cloud-Init 服务识别到该标记会在几毫秒内直接跳过，不再枚举光驱或扫描硬件。
恢复：后续若需在 PVE 修改配置，删除该文件 (sudo rm -f /etc/cloud/cloud-init.disabled) 并重启即可。

方案 B：彻底卸载拔除（极致轻量化）#

适合配置永久固定、后续完全依靠手工或自动化工具维护的独立业务机器。

1. 子机内部卸载组件#

1
sudo apt purge -y cloud-init
2
sudo rm -rf /etc/cloud /var/lib/cloud
3
sudo reboot

2. PVE 宿主机拔除无用光驱硬件#

子机卸载 Cloud-Init 后，挂载在 ide2（或 scsi1）上的配置光盘设备已无意义，将其从硬件配置中移除可省去开机时的总线枚举：

1
# 在 PVE 宿主机执行（以子机 ID 101、原光驱设备挂载在 ide2 为例）
2
qm set 101 --delete ide2