tech 2026年03月07日 · 阅读

在 Proxmox VE (PVE) 上创建 KVM 虚拟机的“最佳实践”，尤其是需要配合 Cloud-init 时，核心思路是“一次配置，多次克隆”。

直接手动创建 VM 效率较低，最专业的做法是先创建一个 Cloud-init 模板 (Template)。

🚀 核心流程：创建 Cloud-init 基础模板

以下是基于官方提供的 Generic Cloud Image（如 Ubuntu, Debian 或 CentOS）的标准化步骤。

1. 下载官方 Cloud 镜像

不要使用普通的 ISO 安装镜像。前往发行版官网下载 .qcow2 格式的镜像（例如 ubuntu-24.04-server-cloudimg-amd64.img）。

2. 通过 CLI 导入镜像 (最稳健的方法)

登录 PVE 的 SSH，执行以下命令（假设 VM ID 为 9000）：

# 创建一个新的 VM
qm create 9000 --memory 2048 --net0 virtio,bridge=vmbr0 --scsihw virtio-scsi-pci

# 导入下载好的 qcow2 镜像到本地存储 (local-lvm 或 local-zfs)
qm importdisk 9000 ubuntu-24.04-server-cloudimg-amd64.img local-lvm

# 将导入的磁盘挂载为 SCSI 设备
qm set 9000 --scsihw virtio-scsi-pci --scsi0 local-lvm:vm-9000-disk-0

# 添加 Cloud-init 驱动器
qm set 9000 --ide2 local-lvm:cloudinit

# 设置引导顺序和显示类型
qm set 9000 --boot c --bootdisk scsi0
qm set 9000 --serial0 socket --vga serial0

3. 在 GUI 中进行预配置

回到 PVE 管理界面，选中 VM 9000：

  • Cloud-init 选项卡：预设好默认用户（User）、密码（Password）、SSH 公钥（SSH Key）和 IP 配置（建议设为 DHCP）。
  • 硬件选项卡：根据需要调整 CPU 核心数和内存。
  • 转换为模板：右键点击该 VM，选择 "Convert to Template"。

🛠 最佳实践建议

🛡️ 硬件设置优化

  • 磁盘控制器：始终选择 VirtIO SCSI Single，并开启 iothread=1。这能提供最佳的 I/O 性能。
  • QEMU Guest Agent：在 Options 中务必开启。这允许 PVE 获取虚拟机的 IP 地址并在关机时发送正确指令。
  • 磁盘丢弃 (Discard)：如果你的底层存储是 SSD，勾选磁盘选项中的 Discard 和 SSD emulation。

📁 存储与扩容

  • 不要在模板里分配太大空间：模板磁盘可以设为 10GB。当你从模板克隆出新 VM 后，可以在 Resources -> Hard Disk 中轻松通过 Resize 增加空间，Cloud-init 会在启动时自动完成分区扩容。

🌐 网络配置

  • MTU 设置：如果你在使用 VLAN 或特定的 SDN 环境，注意网卡的 MTU 要与物理交换机匹配，否则可能会遇到奇怪的网络丢包。

🔄 快速部署工作流

一旦有了模板，以后新建虚拟机的过程只需 30 秒：

  1. 右键点击模板 -> Clone。
  2. 选择 Full Clone（独立性强）或 Linked Clone（节省空间但依赖模板）。
  3. 在新 VM 的 Cloud-init 栏目中修改主机名（Hostname）和 IP。
  4. 点击 Regenerate Image 并启动。

进阶提示

如果你追求极致的自动化，可以研究 Terraform 的 Proxmox Provider。它能让你通过代码定义上述过程，一行命令批量拉起几十台配置好 Cloud-init 的虚拟机。

在 Linux 世界中，.img 和 .qcow2 经常互换使用，但 .qcow2 (QEMU Copy-On-Write) 实际上是 KVM 架构下的最佳格式，因为它支持快照且占用空间动态增长。

PVE 存放 ISO 和离线镜像的默认位置 /var/lib/vz/template/iso/。

按照你的路径，最佳的实践操作步骤如下：

1. 导入并关联镜像

由于 .qcow2 不能像 ISO 那样直接挂载，你需要通过 PVE 的后端命令将其“导入”为虚拟机的磁盘。

假设你要创建的 VM ID 是 101，存储池名称是 local-lvm（请根据你实际的存储名称修改）：

# 1. 创建基础配置 VM (无磁盘状态)
qm create 101 --name debian13-template --memory 2048 --cores 2 --net0 virtio,bridge=vmbr0

# 2. 核心步骤：将你的 qcow2 导入到 VM 的磁盘控制器中
# 注意：这里直接引用你的路径
qm importdisk 101 /var/lib/vz/template/iso/debian-13-generic-amd64-daily.qcow2 local-lvm

# 3. 将导入的磁盘挂载为 SCSI 设备，并开启 SSD 仿真（如果是 SSD 存储）
qm set 101 --scsihw virtio-scsi-pci --scsi0 local-lvm:vm-101-disk-0,discard=on,ssd=1

2. 配置 Cloud-init 必选项

没有这几行配置，Cloud-init 无法生效：

# 添加 Cloud-init CD-ROM 驱动器
qm set 101 --ide2 local-lvm:cloudinit

# 设置引导顺序为 scsi0 (即你导入的那个磁盘)
qm set 101 --boot c --bootdisk scsi0

# 启用串行终端（Cloud镜像通常默认通过 Serial 控制台输出日志，方便排错）
qm set 101 --serial0 socket --vga serial0

# 开启 QEMU Agent (Debian Generic 镜像通常预装了 agent)
qm set 101 --agent enabled=1

3. 在 GUI 界面最后的润色

执行完上述命令后，回到 PVE 网页端：

  1. Cloud-init 菜单：填写你的 User (例如 debian)，填入你的 SSH Public Key。
  2. IP Config：建议选 IPv4: DHCP。
  3. 确认配置：点击上方的 Regenerate Image 按钮。
  4. 转化模板：右键 VM 101 -> Convert to Template。

💡 为什么这是“最佳”做法？

  • 解耦：你的原始 .qcow2 文件保持不动，importdisk 会复制一份到 PVE 的管理卷中，避免误删原始文件导致 VM 崩溃。
  • 性能：使用 virtio-scsi-pci 配合 discard=on 是目前 KVM 性能最强、空间利用率最高的组合。

在 PVE 中，Cloud-init 的配置文件不是实时同步的。当你修改了 SSH Key 或用户后，Proxmox 需要重新生成那个 ide2 对应的 ISO 文件。

命令行触发：其实 qm set 命令会自动触发更新，但如果是克隆后修改，有时需要手动触发。

GUI 触发：在 Cloud-init 面板点击 “Regenerate Image”。如果不点这个，虚拟机启动时读取的还是旧的（甚至空的）配置。
大坑
设置的ssh-key没用，会进不去 😂 很难修

pve selfhosting