KVM 虚拟机硬件指纹刷新工具KVM 虚拟机硬件指纹刷新工具

总是敲命令挺烦的，于是生产了这么个玩意有需要的拿去玩。

初步成型，后期慢慢更新

在deepin v25.2.2中构建的，其它系统没测试

源码主页：https://github.com/yaoyingkeji/kvm-fpr

开源协议：GPL-3.0

主页：www.yaoying.vip

kvm-fpr — KVM 虚拟机硬件指纹刷新工具

一个基于 C 语言 + NAppGUI 开源图形库 的图形化工具，用于刷新现有 KVM 虚拟机的
硬件指纹与机器码：为虚拟机生成全新的 UUID、网卡 MAC 地址、SMBIOS 序列号，
并可选重置 guest 内部 machine-id（机器码），让虚拟机以"全新机器"的身份呈现给系统和应用。

纯开源实现：GUI 使用 NAppGUI（MIT License，与 GPLv3 兼容），本项目源码以 GPLv3 发布，
后端调用系统 libvirt/virsh，无任何闭源组件，无法律风险。

✨ 功能特性

功能	说明
虚拟机列表	一键列出本机 libvirt 管理的全部 KVM 虚拟机
刷新硬件指纹	生成全新 UUID、所有网卡 MAC、SMBIOS 序列号/系统 UUID
智能关机	运行中的虚拟机可选择优雅关机（virsh shutdown）或强制关机（virsh destroy）
机器码重置	可选重置 guest 内部 /etc/machine-id 等机器码（需 virt-customize）
自动备份	刷新前自动备份原始 XML 到 ~/kvm-fpr-backups/，可随时恢复
保留自启	自动保留并恢复虚拟机的开机自启设置
UEFI 支持	含 UEFI nvram 的虚拟机自动重建 nvram

📦 下载安装

提供 三种 GUI 实现，功能一致（见 Releases）：

版本	特点	安装包
NAppGUI 版	单文件、体积最小	kvm-fpr_1.0.1_amd64.deb / kvm-fpr-1.0.1-x86_64.AppImage
GTK3 版	依赖系统 GTK3	kvm-fpr-gtk_1.0.1_amd64.deb / kvm-fpr-gtk-1.0.1-x86_64.AppImage
Qt5 版	依赖系统 Qt5	kvm-fpr-qt_1.0.1_amd64.deb / kvm-fpr-qt-1.0.1-x86_64.AppImage

Debian / Deepin / Ubuntu（.deb）

sudo dpkg -i kvm-fpr_1.0.1_amd64.deb        # NAppGUI 版
sudo dpkg -i kvm-fpr-gtk_1.0.1_amd64.deb    # GTK3 版
sudo dpkg -i kvm-fpr-qt_1.0.1_amd64.deb     # Qt5 版

任意发行版（.AppImage）

chmod +x kvm-fpr-1.0.1-x86_64.AppImage      # NAppGUI 版
./kvm-fpr-1.0.1-x86_64.AppImage
chmod +x kvm-fpr-gtk-1.0.1-x86_64.AppImage  # GTK3 版
./kvm-fpr-gtk-1.0.1-x86_64.AppImage
chmod +x kvm-fpr-qt-1.0.1-x86_64.AppImage   # Qt5 版
./kvm-fpr-qt-1.0.1-x86_64.AppImage

🚀 快速开始

1. 打开程序，点击 「刷新列表」 加载虚拟机；
2. 在下拉框中选择要刷新的虚拟机；
3. 输入 sudo 密码（root 用户可留空；程序需要 root 权限执行 virsh define）；
4. （可选）勾选 「重置 guest 内部 machine-id」；
5. 点击 「刷新硬件指纹 / 机器码」；
6. 日志区显示新旧 UUID / MAC 对比及备份路径，即刷新完成。

⚠️ 刷新过程会短暂 关闭虚拟机（自动或强制），请提前保存 guest 内的工作。

📚 文档

• 使用说明 — 详细操作手册
• 技术说明 — 架构、指纹生成原理与打包方法

🛠 从源码构建

详见 技术说明 · 构建与打包。本项目提供三个 GUI 实现，共用同一后端：

./build.sh          # NAppGUI 版：编译、生成 .deb 与 .AppImage
gtk/build_gtk.sh    # GTK3 版：编译 kvm-fpr-gtk
qt/build_qt.sh      # Qt5 版：编译 kvm-fpr-qt

📄 许可证

本项目源码采用 GNU GPLv3 协议发布（SPDX: GPL-3.0-or-later）。
GUI 库 NAppGUI 为 MIT 许可（与 GPLv3 兼容），
可放心用于商业与个人项目。

作者信息

• 作者：彭刚要
• 邮箱：pgy866@163.com | yaoying@yaoying.vip
• 主页：www.yaoying.vip