VirtualBox增强功能安装失败时，需依次检查ISO挂载、安装内核头文件与依赖、手动挂载执行脚本、禁用Secure Boot、清理旧版残留；Windows客户机须以管理员身份运行并处理驱动签名问题。
如果您在 VirtualBox 中点击“设备→安装增强功能”后无响应、报错或安装失败，则可能是由于内核头文件缺失、Secure Boot 启用、ISO 未正确挂载、依赖包未安装或版本不匹配所致。以下是多种可行的手动安装方案：
一、检查并挂载增强功能 ISO 镜像
该步骤用于确认 Guest Additions 光盘是否真实加载到虚拟机中，避免因光驱被占用或路径错误导致安装入口不可见。
1、关闭正在运行的虚拟机。
2、右键虚拟机名称 → 选择“设置” → 进入“存储”选项卡。
3、展开“控制器：IDE”或“控制器：SATA”，点击空光驱图标右侧的光盘图标 → 选择“选择一个光盘文件”。
4、定位并选中 VBoxGuestAdditions.iso（通常位于 VirtualBox 安装目录，如 C:\Program Files\Oracle\VirtualBox\VBoxGuestAdditions.iso 或 Linux 下 /usr/share/virtualbox/VBoxGuestAdditions.iso）。
5、若已存在其他 ISO（如系统安装盘），请先移除以避免光驱冲突。
二、安装必要编译依赖与内核头文件
此步骤为 Linux 客户机提供构建内核模块所需的工具链和头文件，是解决 “Building the main Guest Additions modules fail!” 的前置条件。
1、更新系统软件包列表：sudo apt update（Ubuntu/Debian）或 sudo yum update -y（CentOS/RHEL）。
2、安装基础构建工具：sudo apt install -y build-essential dkms linux-headers-$(uname -r)（Ubuntu/Debian）。
3、对于 CentOS/RHEL/Fedora：sudo yum install -y gcc make perl kernel-devel kernel-headers bzip2。
4、验证当前运行内核与已安装头文件是否一致：uname -r 与 ls /usr/src/linux-headers-* 输出应匹配；若不匹配，需安装对应版本的 linux-headers-* 包。
三、手动挂载并执行安装脚本
绕过图形界面自动挂载机制，直接通过命令行控制挂载点与安装流程，适用于无桌面环境或自动挂载失效场景。
1、创建挂载目录：sudo mkdir -p /mnt/cdrom。
2、挂载光盘设备：sudo mount /dev/cdrom /mnt/cdrom（若提示 no medium found，尝试 /dev/sr0 替代 /dev/cdrom）。
3、进入挂载目录并赋予执行权限：cd /mnt/cdrom && sudo chmod +x VBoxLinuxAdditions.run。
4、运行安装程序：sudo ./VBoxLinuxAdditions.run。
5、若安装过程中提示执行 /sbin/rcvboxadd quicksetup all，立即运行该命令。
四、禁用 Secure Boot（仅限 UEFI 启动的 Linux 客户机）
Secure Boot 会阻止未签名的 vboxguest、vboxsf 等内核模块加载，导致 modprobe vboxguest 返回 “Operation not permitted”。
1、重启虚拟机，在 GRUB 启动菜单按 e 编辑启动项。
2、找到以 linux 开头的行，在行尾添加空格后追加 systemd.unified_cgroup_hierarchy=0 biosdevname=0 net.ifnames=0 mitigations=off（临时绕过）。
3、按 Ctrl+X 启动；若成功，后续应进入 BIOS/UEFI 设置界面彻底关闭 Secure Boot。
4、关闭 Secure Boot 后，重新执行 sudo /mnt/cdrom/VBoxLinuxAdditions.run。
五、清理旧版残留并重试安装
旧版本 Guest Additions 残留可能干扰新版本模块注册与符号链接，尤其在升级 VirtualBox 主程序后易发。
1、卸载已有增强功能：sudo /opt/VBoxGuestAdditions-*/uninstall.sh（若存在）。
2、手动删除残留目录：sudo rm -rf /opt/VBoxGuestAdditions-* 和 /usr/src/vboxguest-*。
3、清除内核模块缓存：sudo depmod -a。
4、重新挂载 ISO 并执行安装脚本。
六、Windows 客户机专用处理流程
Windows 系统无法使用 shell 脚本，需依赖图形界面与管理员权限完成安装，且对数字签名敏感。
1、确保以管理员身份运行安装程序：右键光盘图标中的 VBoxWindowsAdditions.exe → 选择“以管理员身份运行”。
2、若弹出“驱动程序签名问题”警告，点击“仍要安装”或临时禁用驱动程序强制签名（通过高级启动 → 禁用驱动程序签名强制）。
3、安装过程中勾选全部功能（特别是“安装支持共享文件夹的驱动程序”）。
4、安装完成后，打开设备管理器，检查“系统设备”下是否存在带黄色感叹号的 VirtualBox Guest Service 或 VBoxSF 设备；若有，右键更新驱动程序 → 手动指定路径为光盘根目录。
