oneclickvirt.github.io/docs/guide/pve_kvm.md

outline

outline
deep

KVM虚拟化

SSH登录说明

KVM虚拟化开设出的虚拟机，默认生成的用户名不是root，你需要执行sudo -i切换为root用户

当然部分模板实际支持用户名root登录，默认的root密码是password，你也可以先试试

登录SSH切换为root权限后，一定要修改root密码，可以使用以下命令修改

国际

bash <(curl -sSL https://raw.githubusercontent.com/fscarmen/tools/main/root.sh) [PASSWORD]

国内

bash <(curl -sSL https://ghproxy.com/https://raw.githubusercontent.com/fscarmen/tools/main/root.sh) [PASSWORD]

部分注意事项

执行本项目的检测环境的命令，展示如下

查询如上的只需使用下面的一键脚本自动创建虚拟机即可，无需手动再修改WEB端设置

查询如上的在使用后续脚本创建了虚拟机后，可能需要手动修改WEB端设置，需要关闭对应每个虚拟机的硬件嵌套虚拟化，如下图

先停止虚拟机再修改，修改完后再开机才能使用NOVNC，不关闭可能导致这个虚拟机有BUG无法使用

如果强行安装PVE开KVM，启动不了的也可以关闭这个选项试试能不能启动虚拟机

:::tip 开设虚拟机前请使用screen挂起执行，避免开设时间过长，SSH不稳定导致中间执行中断 :::

开设KVM虚拟机可使用的镜像

• 已预安装开启cloudinit
• 开启SSH登陆
• 预设置SSH监听V4和V6的22端口
• 开启允许密码验证登陆
• 开启允许root登陆
• 部分预安装Qemu-guest-agent

目前可使用的镜像名字的列表为

https://github.com/oneclickvirt/kvm_images/blob/main/list.text

单独开设NAT的KVM虚拟化的虚拟机

• 自动开设NAT服务器，默认使用Debian10镜像，因为该镜像占用最小
• 可在命令中自定义需要使用的镜像，这里有给出配置好的镜像，镜像自带空间设置是2~10G硬盘，日常使用至少10G以上即可，除非某些镜像开不起来再增加硬盘大小
• 可在命令中指定存储盘位置，默认不指定时为local盘即系统盘，可指定为PVE中显示的挂载盘
• 自定义内存大小推荐512MB内存
• 自动进行内外网端口映射，含22，80，443端口以及其他25个内外网端口号一样的端口
• 生成后需要等待一段时间虚拟机内部的cloud-init配置好网络以及登陆信息，大概需要5分钟
• 虚拟机的相关信息将会存储到WEB端对应VM的NOTES中，可在WEB端查看
• 如果宿主机自带IPV6子网将自动附加上IPV6网络，但无公网IPV6地址

国际

curl -L https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/buildvm.sh -o buildvm.sh && chmod +x buildvm.sh

国内

curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/buildvm.sh -o buildvm.sh && chmod +x buildvm.sh

使用方法

• 系统支持：
  • x86_64架构的详见 跳转 中列出的系统，使用时只需写文件名字，不需要.qcow2尾缀
  • arm架构的详见 跳转 中列出的系统，使用时只需要写系统名字+系统版本号，如ubuntu20、ubutnu22这种

:::tip 注意这里的用户名不能是纯数字，会造成cloudinit出问题，最好是纯英文或英文开头 :::

./buildvm.sh VMID 用户名 密码 CPU核数 内存 硬盘 SSH端口 80端口 443端口 外网端口起 外网端口止 系统 存储盘

测试示例

./buildvm.sh 102 test1 oneclick123 1 512 10 40001 40002 40003 50000 50025 debian11 local

开设完毕可执行cat vm102查看信息，或到WEB端对应VM的NOTES中查看

以下为开设的示例VM的信息：

属性	值
VMID	102
SSH登录的用户名	test1
SSH登录的密码	oneclick123
CPU核数	1
内存大小	512MB
磁盘大小	10G
SSH端口	40001
80端口	40002
443端口	40003
内外网映射端口一致的区间	50000到50025
系统	debian11
宿主机的存储盘	local

删除示例

• 停止VM
• 删除VM
• 删除端口映射
• 重启网络
• 删除log文件

qm stop 102
qm destroy 102
iptables -t nat -F
iptables -t filter -F
service networking restart
systemctl restart networking.service
rm -rf vm102

批量开设NAT的KVM虚拟化的虚拟机

:::warning 初次使用前需要保证当前PVE纯净且宿主机未进行过任何端口映射，否则设置冲突可能出现BUG :::

:::tip 开设前请使用screen挂起执行，避免批量开设时间过长，SSH不稳定导致中间执行中断 :::

• 可多次运行批量生成VM
• 自动开设NAT服务器，选项留空默认使用debian11镜像，可自定义使用镜像名字，支持的系统名字详见上文支持的镜像列表
• 自动进行内外网端口映射，含22，80，443端口以及其他25个内外网端口号一样的端口
• 生成后需要等待一段时间虚拟机内部的cloudinit配置好网络以及登陆信息，大概需要5分钟，每个虚拟机创建之间有间隔等待60秒避免突发性能不足
• 默认批量开设的虚拟机网络配置为：22，80，443端口及一个25个端口区间的内外网映射
• 可自定义批量开设的核心数，内存大小，硬盘大小，使用宿主机哪个存储盘，记得自己计算好空闲资源开设
• 虚拟机的相关信息将会存储到WEB端对应VM的NOTES中，可在WEB端查看
• 如果宿主机自带IPV6子网将自动附加上IPV6网络，但无公网IPV6地址

国际

curl -L https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/create_vm.sh -o create_vm.sh && chmod +x create_vm.sh && bash create_vm.sh

国内

curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/create_vm.sh -o create_vm.sh && chmod +x create_vm.sh && bash create_vm.sh

开设完毕可执行cat vmlog查看信息，或到WEB端对应VM的NOTES中查看

删除所有虚拟机

• 删除所有VM
• 删除所有nat的端口映射
• 重启网络
• 删除log文件

for vmid in $(qm list | awk '{if(NR>1) print $1}'); do qm stop $vmid; qm destroy $vmid; rm -rf /var/lib/vz/images/$vmid*; done
iptables -t nat -F
iptables -t filter -F
service networking restart
systemctl restart networking.service
rm -rf vmlog
rm -rf vm*

:::tip PVE修改VM配置前都得停机先，再修改配置，修改完再启动，免得出现配置重载错误 :::

开设独立IPV4地址的虚拟机

两个版本，各取所需

自动选择IPV4地址无需手动指定的版本

:::warning 使用前需要保证当前宿主机的IP段带了至少2个IP，且有空余的IP未配置，该空余的IP未绑定宿主机 :::

• 自动检测可用的IP区间，通过ping检测空余可使用的IP，选取其中之一绑定到虚拟机上
• 如果宿主机自带IPV6子网将可选择是否附加上IPV6地址
• 系统的相关信息将会存储到对应的虚拟机的NOTE中，可在WEB端查看

国际

curl -L https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/buildvm_extraip.sh -o buildvm_extraip.sh && chmod +x buildvm_extraip.sh

国内

curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/buildvm_extraip.sh -o buildvm_extraip.sh && chmod +x buildvm_extraip.sh

创建示例

./buildvm_extraip.sh VMID 用户名 密码 CPU核数 内存大小以MB计算 硬盘大小以GB计算 系统 存储盘 是否附加IPV6(默认为N)

./buildvm_extraip.sh 152 test1 oneclick123 1 1024 10 debian12 local N

上述命令意义为开设一个带独立IPV4地址的虚拟机

属性	值
VMID	152
用户名	test1
密码	oneclick123
CPU	1核
内存	1024MB
硬盘	10G
系统	debian12
存储盘	local盘
IPV6附加	默认不附加

需要手动指定IPV4地址的版本

• 需要手动在命令中指定IPV4地址，且带上子网长度
• 如果宿主机自带IPV6子网将可选择是否附加上IPV6地址
• 如果商家有给IPV4地址和子网长度，请仔细比对，按照下面示例的命令写参数
• 系统的相关信息将会存储到对应的虚拟机的NOTE中，可在WEB端查看

国际

curl -L https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/buildvm_manual_ip.sh -o buildvm_manual_ip.sh && chmod +x buildvm_manual_ip.sh

国内

curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/buildvm_manual_ip.sh -o buildvm_manual_ip.sh && chmod +x buildvm_manual_ip.sh

创建示例

./buildvm_manual_ip.sh VMID 用户名 密码 CPU核数 内存大小以MB计算 硬盘大小以GB计算 系统 存储盘 IPV4地址 是否附加IPV6(默认为N)

./buildvm_manual_ip.sh 152 test1 oneclick123 1 1024 10 debian12 local a.b.c.d/24 N

上述命令意义为开设一个带独立IPV4地址的虚拟机

属性	值
VMID	152
用户名	test1
密码	oneclick123
CPU	1核
内存	1024MB
硬盘	10G
系统	debian12
存储盘	local盘 (系统盘)
IPV4地址	a.b.c.d
子网	/24 子网
IPV6	无

开设纯IPV6地址的虚拟机

前提是宿主机给的是IPV6子网而不是单独一个IPV6地址，且宿主机未开启MAC地址校验

自动选择IPV6地址无需手动指定

• 自动检测可用的IPV6区间，对应虚拟机编号的V6地址绑定到虚拟机上
• 系统的相关信息将会存储到对应的虚拟机的NOTE中，可在WEB端查看

国际

curl -L https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/buildvm_onlyv6.sh -o buildvm_onlyv6.sh && chmod +x buildvm_onlyv6.sh

国内

curl -L https://ghproxy.com/https://raw.githubusercontent.com/spiritLHLS/pve/main/scripts/buildvm_onlyv6.sh -o buildvm_onlyv6.sh && chmod +x buildvm_onlyv6.sh

创建示例

./buildvm_onlyv6.sh VMID 用户名 密码 CPU核数 内存大小以MB计算 硬盘大小以GB计算 系统 存储盘

./buildvm_onlyv6.sh 152 test1 oneclick123 1 1024 10 debian12 local

上述命令意义为开设一个纯IPV6地址的虚拟机

参数	值
VMID	152
用户名	test1
密码	oneclick123
CPU	1核
内存	1024MB
硬盘	10G
系统	debian12
存储盘	local

删除vm152示例

qm stop 152
qm destroy 152
rm -rf vm152