Skip to content

Latest commit

 

History

History
155 lines (114 loc) · 5.96 KB

README.md

File metadata and controls

155 lines (114 loc) · 5.96 KB

qemu

Hits

基于 QEMU/KVM + libvirt 的虚拟机环境一键安装与管理脚本

支持一键安装 QEMU/KVM 运行时，并开设各种 Linux 虚拟机（提供 SSH 访问），支持端口映射、资源限制、cloud-init 自动初始化等。

说明

  • 使用 QEMU/KVM + libvirt 安装完整虚拟化环境
  • 使用官方 Cloud Image（qcow2 格式），自动下载并使用 cloud-init 初始化
  • 支持系统：Debian 10/11/12/13、Ubuntu 18/20/22/24、AlmaLinux 8/9、RockyLinux 8/9、OpenEuler 22
  • 支持架构：amd64、arm64
  • 网络模式：libvirt NAT（virbr0），通过 iptables 进行端口映射
  • 虚拟机信息记录在 /root/vmlog

安装 QEMU/KVM 环境

bash <(curl -sSL https://raw.githubusercontent.com/oneclickvirt/qemu/main/qemuinstall.sh)

开设单个虚拟机

# 下载脚本
curl -sSL -o oneqemu.sh https://raw.githubusercontent.com/oneclickvirt/qemu/main/scripts/oneqemu.sh
chmod +x oneqemu.sh

# 用法 (两种格式均支持):
# ./oneqemu.sh <name> <cpu> <memory_mb> <disk_gb> <password> <sshport> <startport> <endport> [system]
# ./oneqemu.sh <name> <cpu> <memory_mb> <disk_gb> <password> <sshport> <startport> <endport> <extra_flag(y/n)> [system]

# 示例: 创建名为 vm1 的 Debian 虚拟机，1核 1024MB 20GB，SSH端口25001，额外端口35001-35025
./oneqemu.sh vm1 1 1024 20 MyPassword 25001 35001 35025 debian
# 示例: 第 9 个参数为附加标志（y/n），第 10 个参数为系统名
./oneqemu.sh vm1 1 1024 10 MyPassword 25000 34975 35000 n debian13
参数 说明 默认值
name 虚拟机名称 vm1
cpu CPU 核数 1
memory_mb 内存限制（MB） 1024
disk_gb 磁盘大小（GB） 20
password root 密码 123456
sshport 宿主机 SSH 映射端口 25001
startport 额外端口范围起始 35001
endport 额外端口范围结束 35025
system 系统类型（第 9 或第 10 个参数） debian

支持的 system 值：

系统名 支持版本号 示例
debian 10 11 12 13 debian debian12 debian13
ubuntu 18 20 22 24 ubuntu ubuntu22 ubuntu24
almalinux 8 9 almalinux9（alma9 亦可）
rockylinux 8 9 rockylinux9（rocky9 亦可）
openeuler 22 openeuler

system 名称不区分大小写，支持带 - 或 _ 分隔符（如 debian-13、ubuntu_22），均可自动规范化。

批量开设虚拟机

curl -sSL -o create_qemu.sh https://raw.githubusercontent.com/oneclickvirt/qemu/main/scripts/create_qemu.sh
chmod +x create_qemu.sh
./create_qemu.sh

交互式脚本，自动递增虚拟机名（vm1, vm2, ...）、SSH 端口、公网端口，虚拟机信息记录到 vmlog 文件。

说明： 脚本不会阻塞等待 cloud-init 完成。DHCP 预留和端口转发规则在 VM 启动前已配置完毕，cloud-init 在后台运行；初始化完成（密码设置、SSH 配置等）后 VM 自动关机并重启。可通过以下命令查看初始化进度：

tail -f /tmp/qemu-init-<vm_name>.log

查看与管理虚拟机

virsh list --all                    # 查看所有虚拟机
virsh console <name>                # 进入虚拟机控制台（Ctrl+] 退出）
virsh start <name>                  # 启动虚拟机
virsh shutdown <name>               # 优雅关闭虚拟机
virsh destroy <name>                # 强制关闭虚拟机
virsh reboot <name>                 # 重启虚拟机
virsh dominfo <name>                # 查看虚拟机信息
virsh domifaddr <name>              # 查看虚拟机 IP 地址

删除单个虚拟机

curl -sSL -o delete_qemu.sh https://raw.githubusercontent.com/oneclickvirt/qemu/main/scripts/delete_qemu.sh
chmod +x delete_qemu.sh
./delete_qemu.sh <vm_name>

脚本会自动清理：虚拟机定义、磁盘镜像、DHCP 预留、iptables 端口转发规则、日志记录。

卸载（完整清理）

一键卸载 QEMU/KVM 全套环境，包括所有虚拟机、磁盘镜像、网络配置、systemd 服务、软件包：

bash <(curl -sSL https://raw.githubusercontent.com/oneclickvirt/qemu/main/qemuuninstall.sh)

脚本会在执行前要求输入 yes 确认，操作不可逆。

镜像说明

本项目使用各发行版官方 Cloud Image（cloud-init 格式），首次使用时自动下载至 /var/lib/libvirt/images/，后续创建同系统虚拟机不再重复下载：

系统 镜像来源
Debian 10/11/12/13 cloud.debian.org
Ubuntu 18/20/22/24 cloud-images.ubuntu.com
AlmaLinux 8/9 repo.almalinux.org
RockyLinux 8/9 dl.rockylinux.org
OpenEuler 22 repo.openeuler.org

网络说明

  • 使用 libvirt 的 default NAT 网络（virbr0，192.168.122.0/24）
  • 虚拟机获得 192.168.122.2~192.168.122.99 范围内的静态 IP（通过 DHCP 预留）
  • 通过 /etc/libvirt/hooks/qemu + iptables DNAT 实现宿主机端口到虚拟机端口的映射
  • SSH 端口映射：宿主机:sshport → vm_ip:22
  • 额外端口映射：宿主机:startport-endport → vm_ip:startport-endport

日志文件

虚拟机信息保存在 /root/vmlog，格式如下：

vm1 25001 passwd123 1 1024 20 35001 35025 debian 192.168.122.2
vm2 25002 passwd456 1 1024 20 35026 35050 ubuntu 192.168.122.3

字段顺序：名称 SSH端口 密码 CPU核数 内存MB 磁盘GB 起始端口 结束端口 系统 内网IP

资源要求

项目 最低要求
CPU 支持 VT-x/AMD-V 硬件虚拟化（或嵌套虚拟化）
内存 宿主机剩余 >= 虚拟机内存 + 512MB
磁盘 宿主机剩余 >= 虚拟机磁盘 × 台数
OS Ubuntu 22.04+、Debian 11+、CentOS 7+

Stargazers over time

Stargazers over time