kubevirt

基于 KubeVirt + K3s 的虚拟机环境一键安装与管理脚本

支持一键安装 KubeVirt 运行时，并开设各种 Linux 虚拟机（提供 SSH 访问），支持 CPU、内存、磁盘资源限制，端口映射，cloud-init 初始化等。

• 使用 K3s 作为轻量级 Kubernetes，自动安装单节点集群
• 使用 KubeVirt 提供虚拟机能力（基于 KVM/QEMU）
• 使用 CDI（Containerized Data Importer）导入云镜像
• 通过 nftables/iptables DNAT 实现端口映射
• 支持系统：Ubuntu 22.04/24.04, Debian 11/12, AlmaLinux 9, RockyLinux 9, CentOS 7, CentOS Stream 8/9, openSUSE Leap 15.5
• 支持架构：amd64 (x86_64)
• 宿主机系统支持：Ubuntu 20.04/22.04/24.04，Debian 11/12

• 宿主机需支持 KVM 虚拟化（/dev/kvm 存在且可用）
• 最低配置：2 核 CPU，4GB RAM，20GB 可用磁盘
• root 权限运行
• 需要公网访问以下载 K3s、KubeVirt 组件和虚拟机镜像

export noninteractive=true
bash <(curl -sSL https://raw.githubusercontent.com/oneclickvirt/kubevirt/main/kubevirtinstall.sh)

安装完成后会把常用管理脚本安装到 /usr/local/bin，可直接运行 onevm.sh、create_vm.sh、listvms.sh、snapshotvm.sh、resizevm.sh、deletevm.sh 和 update-port-rules.sh。

弱网或离线环境可提前准备安装文件后运行：

export noninteractive=true
export K3S_INSTALL_SCRIPT=/path/to/k3s-install.sh
export KUBEVIRT_MANIFEST_DIR=/path/to/kubevirt-manifests
export CDI_MANIFEST_DIR=/path/to/cdi-manifests
export VIRTCTL_BINARY=/path/to/virtctl
export KUBEVIRT_SCRIPT_DIR=/path/to/kubevirt
bash kubevirtinstall.sh

curl -sSL -o onevm.sh https://raw.githubusercontent.com/oneclickvirt/kubevirt/main/scripts/onevm.sh
chmod +x onevm.sh
export noninteractive=true
./onevm.sh <name> <cpu> <memory_gb> <disk_gb> <password> <sshport> <startport> <endport> [system]

参数说明：

支持的系统：

示例：

export noninteractive=true
./onevm.sh vm1 2 2 20 MyPassword 25000 34975 35000 debian

curl -sSL -o create_vm.sh https://raw.githubusercontent.com/oneclickvirt/kubevirt/main/scripts/create_vm.sh
chmod +x create_vm.sh
export noninteractive=true
./create_vm.sh

curl -sSL -o listvms.sh https://raw.githubusercontent.com/oneclickvirt/kubevirt/main/scripts/listvms.sh
chmod +x listvms.sh
export noninteractive=true
./listvms.sh

curl -sSL -o snapshotvm.sh https://raw.githubusercontent.com/oneclickvirt/kubevirt/main/scripts/snapshotvm.sh
chmod +x snapshotvm.sh
export noninteractive=true
./snapshotvm.sh vm1 vm1-snapshot-001

说明：

• 快照通过 CDI 从 vm1-dv 克隆出新的 DataVolume，不会直接创建新 VM。
• 默认拒绝对运行中的 VM 创建快照，避免数据不一致；如确认可接受风险，可设置 ALLOW_RUNNING_SNAPSHOT=true。
• 默认等待克隆完成，可用 WAIT_SNAPSHOT=false 改为提交任务后立即返回。

curl -sSL -o resizevm.sh https://raw.githubusercontent.com/oneclickvirt/kubevirt/main/scripts/resizevm.sh
chmod +x resizevm.sh
export noninteractive=true
./resizevm.sh vm1 4 8 40

说明：

• 参数依次为 vmname cpu memory_gb disk_gb，留空表示不调整对应资源，例如：./resizevm.sh vm1 "" "" 40。
• CPU/内存会更新 VM 模板；运行中的 VM 通常需要重启后完全生效，可设置 RESTART_VM=true 自动重启。
• 磁盘只支持扩容，且依赖 StorageClass 支持 PVC 扩容；虚拟机内文件系统可能仍需手动扩容。

curl -sSL -o deletevm.sh https://raw.githubusercontent.com/oneclickvirt/kubevirt/main/scripts/deletevm.sh
chmod +x deletevm.sh
export noninteractive=true
./deletevm.sh <name>

默认会保留该 VM 的快照 DataVolume，避免误删备份；如需一并删除，设置 DELETE_SNAPSHOTS=true。

export noninteractive=true
bash <(curl -sSL https://raw.githubusercontent.com/oneclickvirt/kubevirt/main/kubevirtuninstall.sh)

批量开设时，连接信息会记录在当前目录的 vmlog 文件中，格式如下：

vm1 root@<宿主机IP>:25000 密码: MyPassword 端口范围: 34975-35000
vm2 root@<宿主机IP>:25001 密码: MyPassword 端口范围: 35001-35026

宿主机（K3s + KubeVirt）
├── K3s Kubernetes（单节点）
│   ├── KubeVirt Operator（管理虚拟机生命周期）
│   └── CDI（导入云镜像到 PVC）
├── 虚拟机 Pod（virt-launcher）
│   ├── vm1（QEMU/KVM）
│   │   ├── SSH :22  ←→  iptables DNAT → 宿主机:25000
│   │   └── 额外端口 ←→  iptables DNAT → 宿主机:34975-35000
│   └── vm2（QEMU/KVM）
│       ├── SSH :22  ←→  iptables DNAT → 宿主机:25001
│       └── 额外端口 ←→  iptables DNAT → 宿主机:35001-35026

# 查看所有虚拟机状态
kubectl get vm -n kubevirt-vms

# 查看虚拟机实例（运行中的）
kubectl get vmi -n kubevirt-vms

# 查看数据卷导入进度
kubectl get dv -n kubevirt-vms

# 进入虚拟机串口控制台（Ctrl+] 退出）
virtctl console <vmname> -n kubevirt-vms

# 启动/停止/重启虚拟机
virtctl start <vmname> -n kubevirt-vms
virtctl stop <vmname> -n kubevirt-vms
virtctl restart <vmname> -n kubevirt-vms

1. 虚拟机首次启动需要等待镜像下载导入（根据网速可能需要 5-20 分钟）
2. 宿主机需要开启 KVM 嵌套虚拟化或直接使用裸金属服务器
3. 端口转发通过 iptables/nftables 实现（支持 IPv4 + IPv6 双栈）：
   • 使用 systemd 服务在重启后自动恢复规则
   • Debian/Ubuntu 系统自动安装 iptables-persistent 和 netfilter-persistent
   • Red Hat/CentOS 系统自动安装 iptables-services
   • 规则变更后自动持久化，确保重启后不失效
   • 脚本按 VMI 实际地址族分别建立规则，IPv6-first 或 IPv6-only 的 VMI 不会被写入 IPv4 DNAT 规则
   • K3s 的默认安装仍是 IPv4-only；要让 VMI 获得 IPv6，须先按 K3s/CNI 文档配置集群双栈或 IPv6 网络
4. 当前脚本仅支持 amd64/x86_64；ARM64 未提供镜像和 KubeVirt 兼容性保证
5. CentOS 7 已 EOL，仅作为兼容镜像选项保留，生产环境建议使用 Debian/Ubuntu/Rocky/AlmaLinux
6. 如需重置密码，通过 virtctl console 进入控制台手动修改

K3s 安装失败怎么办？

安装脚本会输出 /tmp/k3s-install-log.txt 最近日志、systemctl status k3s 和 journalctl -u k3s 片段。优先检查网络/DNS、root 权限、systemd、内核和防火墙限制。

镜像导入失败或超时后会留下资源吗？

默认会清理本次创建的 VM、DataVolume、PVC 和 cloud-init Secret。需要保留现场时设置 KEEP_FAILED_RESOURCES=true。

为什么 listvms.sh <vmname> 不再显示密码？

新 VM 默认不把明文密码写入 Kubernetes 注解，避免普通元数据查询泄露密码。密码仍会用于 cloud-init 初始化，并记录在创建时输出和本地 vmlog 中；listvms.sh 默认会对 vmlog 密码脱敏。如确需后续从 VM 注解或 vmlog 查询，创建时设置 STORE_PASSWORD_ANNOTATION=true，查询时再设置 SHOW_PASSWORD=true。

快照是否等同于应用一致性备份？

不是。snapshotvm.sh 使用 CDI DataVolume 克隆。运行中 VM 的磁盘可能存在未刷盘数据，建议先停止 VM 再创建快照。