适合第一次部署。下载 VHDX、Manifest 和 SHA-256 三个文件,放进模板目录后扫描。
打开模板下载站先选择:自己制作,还是下载现成模板?
如果只是想尽快测试开通,优先下载已经验证过的现成模板。如果要安装自己的软件、补丁或安全策略,再自己制作。
开始前准备
不要拿正在运营的客户 VM 制作。
ISO、临时 VM、最终 VHDX 至少预留 100GB。
安装更新时需要联网,封装前再清理固定网络信息。
系统版本、Generation、管理员账号、启动方式必须和 Manifest 一致。
D:\Templates\ISO,制作中的临时 VM 放在 D:\Hyper-V\TemplateBuild,最终模板放在 Manager“存储与模板”页面显示的模板目录。软件与系统官方下载地址
以下只放官方来源。系统版本会更新,因此使用官方选择页,不使用来源不明的网盘镜像。
Windows Server 模板制作:完整流程
下载 ISO,并验证文件没有损坏
- 从上面的 Microsoft 官方页面下载简体中文 64 位 ISO。
- 把 ISO 放到
D:\Templates\ISO。 - 以管理员身份打开 PowerShell,执行下面命令。能正常返回 64 位 SHA-256 就说明文件可读取。
Get-FileHash -Algorithm SHA256 "D:\Templates\ISO\Windows_Server_2022.iso"
在 Hyper-V 管理器创建专用模板 VM
- 打开“服务器管理器”→“工具”→“Hyper-V 管理器”。
- 右侧点击“新建”→“虚拟机”→“下一步”。
- 名称填写
TEMPLATE-WIN2022,位置选择D:\Hyper-V\TemplateBuild。 - “指定代数”选择第二代。创建后不能再改代数。
- 启动内存建议 4096MB;制作时可以不开动态内存。
- 网络选择一个能临时访问互联网的外部虚拟交换机。
- 创建 VHDX,路径放在临时 VM 目录,大小填写 60GB。
- 安装选项选择“从可启动映像文件安装”,选中刚下载的 ISO。
- 确认摘要,点击“完成”。
Microsoft Windows。安装 Windows Server
- 连接 VM,点击“启动”。出现“Press any key to boot from CD or DVD”时马上按 Enter。
- 选择语言、时间和键盘,点击“现在安装”。
- 选择带“桌面体验”的版本(需要图形界面时),不要误选 Server Core。
- 选择“自定义:仅安装 Windows”。
- 选中 60GB 未分配空间,直接点击“下一步”,让安装程序自动分区。
- 等待安装完成,设置 Administrator 临时密码并登录。
更新系统并做基础检查
- 反复运行 Windows Update,直到没有必须安装的更新。
- 设备管理器中不能有未知设备。
- 确认系统盘是 C 盘,且系统能正常关机、重启。
- 不要加入域,不要写入客户 IP、客户密码、授权码和业务数据。
- 需要预装软件时现在安装;安装完成后重启一次,确认软件正常。
Get-ComputerInfo | Select-Object WindowsProductName,WindowsVersion,OsBuildNumber Get-Disk | Format-Table Number,FriendlyName,PartitionStyle,OperationalStatus Get-NetAdapter | Format-Table Name,Status,MacAddress,LinkSpeed
封装前清理
- 卸载只用于制作模板的临时工具。
- 清空回收站和临时文件。
- 确认 Windows 没有等待重启的更新。
- 把网络改回 DHCP;不要保留模板制作网络的固定 IP。
- 关闭所有程序,只保留管理员 PowerShell。
Get-NetIPInterface -AddressFamily IPv4 | Format-Table InterfaceAlias,Dhcp,ConnectionState powercfg /h off Dism.exe /Online /Cleanup-Image /StartComponentCleanup
运行 Sysprep 通用化,并让 VM 自动关机
这是 Windows 模板最关键的一步。必须带 /generalize,否则复制出来的 VM 会保留 SID 和设备身份。
C:\Windows\System32\Sysprep\Sysprep.exe /generalize /oobe /shutdown /mode:vm
- 命令执行后耐心等待,VM 会自动关机。
- Hyper-V 管理器状态必须显示“已关闭”。
- 从现在开始绝对不要再次启动这个模板 VM。一旦误启动,应重新执行本步骤后再取盘。
Microsoft 官方说明:Sysprep 命令行选项。
在宿主机复制系统盘,生成最终 VHDX
- 先在 VM“设置”→“SCSI 控制器”→“硬盘驱动器”里确认系统 VHDX 的真实路径。
- 确认 VM 已关闭,没有检查点,没有挂载 ISO。
- 把系统 VHDX复制到 Manager 显示的模板目录。
- 文件名只用英文、数字、短横线,避免空格和特殊符号。
$source = "D:\Hyper-V\TemplateBuild\TEMPLATE-WIN2022\Virtual Hard Disks\TEMPLATE-WIN2022.vhdx"
$target = "D:\Templates\Windows-Server-2022-Template.vhdx"
if ((Get-VM "TEMPLATE-WIN2022").State -ne "Off") { throw "模板 VM 尚未关机" }
Copy-Item -LiteralPath $source -Destination $target
Get-Item -LiteralPath $target | Select-Object FullName,Length,IsReadOnly创建 Windows Manifest
在 VHDX 旁边创建 Windows-Server-2022-Template.vhdx.template.json,内容如下。imageCode 是业务系统真正使用的模板编号。
{
"schemaVersion": 2,
"imageCode": "windows-server-2022-dc-gui-zh-cn",
"displayName": "Windows Server 2022 Datacenter GUI zh-CN",
"enabled": true,
"generation": 2,
"secureBootEnabled": true,
"secureBootTemplate": "MicrosoftWindows",
"guestOs": "windows",
"osFamily": "windows",
"osDistribution": "windows-server",
"adminUsername": "Administrator",
"defaultLoginUser": "Administrator",
"defaultLoginProtocol": "rdp",
"defaultLoginPort": 3389,
"provisioningMode": "windows-unattend",
"supportsReinstall": true,
"supportsPasswordChange": true,
"supportsCustomRemotePort": true,
"supportsAdditionalIpAddresses": true,
"supportsSecurityGroup": true,
"supportsConsole": true,
"cloudInitRequired": false,
"dataDiskSupported": true,
"minimumSystemDiskGB": 60,
"maximumSystemDiskGB": 65536
}生成 SHA-256、设置只读、扫描验收
$vhdx = "D:\Templates\Windows-Server-2022-Template.vhdx" $hash = (Get-FileHash -Algorithm SHA256 -LiteralPath $vhdx).Hash Set-Content -LiteralPath ($vhdx + ".sha256") -Value $hash -Encoding Ascii Set-ItemProperty -LiteralPath $vhdx -Name IsReadOnly -Value $true Get-Item -LiteralPath $vhdx | Select-Object FullName,Length,IsReadOnly Get-Content -LiteralPath ($vhdx + ".sha256")
- 打开 WhaleEngine Manager。
- 进入“存储与模板”。
- 确认模板目录就是 VHDX 所在目录。
- 点击“扫描模板目录”。
- 结果必须显示“可用”,不能出现只读、SHA-256 或 Manifest 错误。
- 在业务系统执行“同步节点模板”,再用测试 IP 创建一台 VM。
- 验证主机名、管理员密码、IP、网关、DNS、RDP 随机端口、控制台和系统盘扩容。
Linux 模板制作:完整流程
选择一个仍在维护的 Linux 版本
新模板优先 Ubuntu LTS、Rocky Linux 或 AlmaLinux 当前受支持版本。CentOS 7 已结束生命周期,只用于兼容旧业务,不建议新部署。
- 从本页“软件下载”中的官方地址下载 x86_64/amd64 Server 或 Minimal ISO。
- 下载同目录的 CHECKSUM/SHA256SUMS。
- 把 ISO 放进
D:\Templates\ISO并校验 SHA-256。
Get-FileHash -Algorithm SHA256 "D:\Templates\ISO\ubuntu-24.04-live-server-amd64.iso"
创建 Linux 模板 VM
- 新建 VM,名称例如
TEMPLATE-UBUNTU2404。 - 选择第二代。
- 分配 2 个 vCPU、2048–4096MB 内存。
- 系统盘创建 30GB VHDX。
- 连接能临时上网的虚拟交换机。
- 挂载下载的 Linux ISO。
- 右键 VM →“设置”→“安全性”→启用安全启动,模板选择
Microsoft UEFI 证书颁发机构。
secureBootEnabled 改为 false。安装 Ubuntu:按安装界面逐项选择
- 启动 VM,选择“Try or Install Ubuntu Server”。
- 语言可选 English;键盘按实际选择。
- 网络先使用 DHCP,保证安装阶段能上网。
- Proxy 留空;Mirror 使用默认或可访问的镜像源。
- Storage 选择“Use an entire disk”,确认只操作这台模板 VM 的 30GB 虚拟盘。
- Profile 临时创建
templateadmin用户和临时密码;主机名填写template-linux。 - SSH Setup 勾选“Install OpenSSH server”。
- 不需要安装额外 Snap 软件,等待安装完成后重启。
- 重启前如果提示移除安装介质,在 Hyper-V 设置中弹出 ISO,再按 Enter。
Rocky/AlmaLinux 安装时选择 Minimal Install、自动分区、启用网络并设置 root 临时密码;其余流程相同。
安装并启用 cloud-init、SSH 和扩盘工具
下面两组命令只能选与你系统匹配的一组,不要两组都执行。
sudo apt update sudo apt -y full-upgrade sudo apt -y install cloud-init cloud-guest-utils openssh-server python3 e2fsprogs sudo systemctl enable --now ssh cloud-init --version systemctl is-enabled ssh ss -lntp | grep ':22'
sudo dnf -y update sudo dnf -y install cloud-init cloud-utils-growpart openssh-server python3 e2fsprogs sudo systemctl enable --now cloud-init sshd cloud-init --version systemctl is-enabled sshd ss -lntp | grep ':22'
确认 NoCloud 数据源可用
WhaleEngine 会给新 VM 挂载标签为 CIDATA 的 NoCloud ISO。模板必须允许 cloud-init 从 NoCloud 读取配置。
cloud-init status --long test -d /etc/cloud && echo "cloud-init 配置目录存在" grep -R "NoCloud" /etc/cloud/cloud.cfg /etc/cloud/cloud.cfg.d 2>/dev/null || true
not_ready:cloud_init。禁用文本控制台自动黑屏
这样 HTML5 控制台长时间打开后仍能看到登录界面,不需要先按 Enter 唤醒。
sudo sed -i 's/^GRUB_CMDLINE_LINUX_DEFAULT="\(.*\)"/GRUB_CMDLINE_LINUX_DEFAULT="\1 consoleblank=0"/' /etc/default/grub sudo update-grub
sudo grubby --update-kernel=ALL --args="consoleblank=0"
如果命令提示参数已经存在,不需要重复添加。Agent 首次开通时也会再次保证 consoleblank=0。
封装前清理 Linux 唯一身份
- 确认系统更新完毕并重启一次。
- 重新登录,确认 SSH、cloud-init 都存在。
- 清理 cloud-init 状态、机器 ID、SSH Host Key、日志和 Shell 历史。
- 执行关机,之后不要再次启动。
sudo cloud-init clean --logs --machine-id
sudo rm -rf /var/lib/cloud/instances/* /var/lib/cloud/instance
sudo rm -f /etc/ssh/ssh_host_*
sudo truncate -s 0 /etc/machine-id
sudo rm -f /var/lib/dbus/machine-id
sudo ln -s /etc/machine-id /var/lib/dbus/machine-id
sudo rm -f /root/.bash_history /home/*/.bash_history
sudo find /var/log -type f -exec truncate -s 0 {} \;
sudo sync
sudo fstrim -av || true
sudo shutdown -h nowcloud-init clean --machine-id 会把系统恢复到可克隆状态;新 VM 首次启动时会生成新的机器身份和 SSH Host Key。
在宿主机复制 Linux 系统盘
$source = "D:\Hyper-V\TemplateBuild\TEMPLATE-UBUNTU2404\Virtual Hard Disks\TEMPLATE-UBUNTU2404.vhdx"
$target = "D:\Templates\ubuntu-24.04-x86_64.vhdx"
if ((Get-VM "TEMPLATE-UBUNTU2404").State -ne "Off") { throw "模板 VM 尚未关机" }
Copy-Item -LiteralPath $source -Destination $target
Get-Item -LiteralPath $target | Select-Object FullName,Length,IsReadOnly创建 Linux Manifest
在 VHDX 旁边创建 ubuntu-24.04-x86_64.vhdx.template.json:
{
"schemaVersion": 2,
"imageCode": "ubuntu-24.04-x86_64",
"displayName": "Ubuntu 24.04 LTS x86_64",
"enabled": true,
"generation": 2,
"secureBootEnabled": true,
"secureBootTemplate": "MicrosoftUEFICertificateAuthority",
"guestOs": "linux",
"osFamily": "linux",
"osDistribution": "ubuntu-24.04",
"adminUsername": "root",
"defaultLoginUser": "root",
"defaultLoginProtocol": "ssh",
"defaultLoginPort": 22,
"provisioningMode": "cloud-init-nocloud",
"supportsReinstall": true,
"supportsPasswordChange": true,
"supportsCustomRemotePort": true,
"supportsAdditionalIpAddresses": true,
"supportsSecurityGroup": true,
"supportsConsole": true,
"cloudInitRequired": true,
"dataDiskSupported": true,
"minimumSystemDiskGB": 30,
"maximumSystemDiskGB": 65536,
"linuxInitSystem": "systemd",
"linuxFirewall": "ufw",
"sshConfigMode": "dropin-or-main-config"
}Rocky/AlmaLinux 只需要对应修改 imageCode、displayName、osDistribution,并把 linuxFirewall 改成 firewalld。
生成 SHA-256、设置只读、扫描验收
$vhdx = "D:\Templates\ubuntu-24.04-x86_64.vhdx" $hash = (Get-FileHash -Algorithm SHA256 -LiteralPath $vhdx).Hash Set-Content -LiteralPath ($vhdx + ".sha256") -Value $hash -Encoding Ascii Set-ItemProperty -LiteralPath $vhdx -Name IsReadOnly -Value $true Get-Item -LiteralPath $vhdx | Select-Object FullName,Length,IsReadOnly Get-Content -LiteralPath ($vhdx + ".sha256")
- Manager →“存储与模板”→确认模板目录。
- 点击“扫描模板目录”,必须显示“可用”。
- 业务系统执行“同步节点模板”。
- 创建测试 VM,观察任务应从 90% 进入 100%,不能超时。
- 验证 root 密码、随机 SSH 端口、IP、网关、DNS、防火墙、系统盘扩容、数据盘和 HTML5 控制台。
- 在测试 VM 执行
cloud-init status --long,状态必须是 done。 - 检查
/var/lib/fastmos/provisioning.json,必须包含 ready。
把模板放入 WhaleEngine:最后 5 步
- 确认目录:打开 Manager →“存储与模板”,查看“模板目录”,不要凭感觉写死为 D 盘。
- 复制 3 个文件:VHDX、
.sha256、.template.json放在同一目录。 - 扫描:点击“扫描模板目录”,Manager 会核对并把目录中的 VHDX 设置为只读。
- 同步:回到业务系统执行“同步节点模板”。Agent 扫描成功不代表业务系统已同步。
- 真实开通:用独立测试 IP 开一台最小规格 VM,验证成功后才允许正式售卖。
D:\Templates\ubuntu-24.04-x86_64.vhdx
D:\Templates\ubuntu-24.04-x86_64.vhdx.sha256
D:\Templates\ubuntu-24.04-x86_64.vhdx.template.json
常见错误:看到提示后怎么处理
Golden template must be read-only
VHDX 没有只读属性。Manager 中点击“扫描模板目录”,或执行 Set-ItemProperty -LiteralPath "模板.vhdx" -Name IsReadOnly -Value $true。
Template SHA-256 sidecar file was not found
缺少 模板.vhdx.sha256。重新执行本页生成 SHA-256 的命令。不要把文件命名成只有 模板.sha256。
Template manifest was not found / invalid JSON
Manifest 缺失、文件名不对应或 JSON 多了逗号。最简单的命名是 模板.vhdx.template.json;用本页完整示例修改,不要删除必填字段。
Windows VM 一直停在 OOBE 或开通失败
通常是没有正确执行 Sysprep,或 Sysprep 后又启动过模板 VM。重新在模板 VM 执行 /generalize /oobe /shutdown /mode:vm,关机后重新复制 VHDX。
Linux 开通停在 90%,提示 not_ready:cloud_init
模板缺少 cloud-init、数据源被锁定成非 NoCloud,或封装前没有 clean。回到 Linux 第 4、5、7 步逐项核对。
Linux 提示 not_ready:fastmos_marker
cloud-init 已启动,但 Agent 注入的首次启动脚本没有执行完。先看 cloud-init status --long、/var/log/cloud-init-output.log 和 SSH/防火墙状态,不要反复点击重开。
下载模板后扫描不到
先确认 Manager 配置的模板目录和下载保存目录完全一致;Agent 只扫描配置目录顶层的 *.vhdx,不会递归扫描子文件夹。扫描成功后还要在业务系统同步节点模板。
修改过 VHDX 后又提示 SHA-256 错误
任何 VHDX 内容变化都会让旧哈希失效。先取消只读、完成修改并重新封装,然后重新计算 SHA-256,最后再设为只读。
正式上线前逐项打勾
| 检查项 | Windows | Linux |
|---|---|---|
| VHDX 位于 Manager 配置的模板目录顶层 | 必须 | 必须 |
| VHDX 已设为只读 | 必须 | 必须 |
| 同名 .sha256 存在且与当前文件一致 | 必须 | 必须 |
| 同名 .template.json 字段正确 | 必须 | 必须 |
| 虚拟机代数与 Manifest 一致 | 第二代 | 推荐第二代 |
| 通用化/首次启动组件 | Sysprep generalize | cloud-init NoCloud |
| 默认管理入口 | Administrator / RDP 3389 | root / SSH 22 |
| Manager 扫描结果 | 可用 | 可用 |
| 测试开通结果 | 100% 且 RDP 可登录 | 100% 且 SSH 可登录 |
| 网络、密码、随机端口、扩盘、控制台 | 全部验证 | 全部验证 |