VirtualBox 拖放失败，修复 Guest Additions 安装与拖放功能问题

在使用 Oracle VirtualBox 时，我们常常希望直接从主机（Host）拖拽文件到虚拟机（Guest）中，提高工作效率。但很多用户会遇到如下错误：

DnD: Error: Drag and drop to guest not possible -- either the guest OS does not support this, or the Guest Additions are not installed.
返回代码: VBOX_E_DND_ERROR (0x80BB0011)

或者尝试自动更新 Guest Additions 时出现：

Guest Additions Update failed: Creating update directory "" on guest failed: VERR_BROKEN_PIPE
返回代码: VBOX_E_IPRT_ERROR (0x80BB0005)

这些错误通常指向同一个根源：Guest Additions 未正确安装或已损坏。

---

什么是 Guest Additions？

Guest Additions 是 VirtualBox 提供的一组驱动和系统工具，安装后可实现：

• 自动调整虚拟机分辨率
• 共享剪贴板（复制粘贴）
• 拖放文件（Drag & Drop）
• 共享文件夹
• 更好的鼠标集成和 3D 加速

注意：即使你“看到”了 Guest Additions 光盘，也不代表它已成功安装！

---

正确修复步骤（推荐手动安装）

核心原则：不要依赖“自动更新”，手动安装最可靠！

第一步：确保虚拟机处于正常运行状态

• 启动虚拟机；
• 必须登录到图形桌面环境（如 Windows 桌面、Ubuntu GNOME 等）；
• 不要停留在登录界面或纯命令行（TTY）。

第二步：卸载旧版 Guest Additions（可选但推荐）

▶ Windows 客户机：

1. 打开“控制面板” → “程序和功能”；
2. 找到 Oracle VM VirtualBox Guest Additions；
3. 卸载它，然后重启虚拟机。

▶ Linux 客户机：

# 卸载脚本（如果存在）
sudo /opt/VBoxGuestAdditions-*/uninstall.sh

# 或使用包管理器（如 Ubuntu/Debian）
sudo apt remove --purge virtualbox-guest*

# 清理残留
sudo rm -rf /opt/VBoxGuestAdditions-*

完成后重启虚拟机。

---

第三步：手动安装 Guest Additions

1. 在 VirtualBox 主界面，点击菜单：

   设备（Devices） → 插入 Guest Additions CD 映像…

2. 虚拟机内会挂载一个名为 VBox_GAs_*.iso 的虚拟光盘。

▶ Windows 安装步骤：

• 打开“此电脑”；
• 双击进入 Guest Additions 光盘；
• 右键 VBoxWindowsAdditions.exe → 以管理员身份运行；
• 安装向导中确保勾选：
  • Guest Additions
  • Drag and Drop
  • Shared Clipboard
• 安装完成后 重启虚拟机。

▶ Linux 安装步骤（以 Ubuntu/Debian 为例）：

# 1. 挂载光盘（若未自动挂载）
sudo mkdir -p /mnt/cdrom
sudo mount /dev/cdrom /mnt/cdrom

# 2. 运行安装脚本
cd /mnt/cdrom
sudo ./VBoxLinuxAdditions.run

# 3. 验证是否加载成功
lsmod | grep vboxguest

若提示 gcc not found 或 kernel headers missing，请先安装对应开发包。

安装完成后 务必重启虚拟机！

---

第四步：启用拖放功能

1. 关闭虚拟机（必须关机状态才能修改设置）；
2. 在 VirtualBox 主界面，选中你的虚拟机 → 设置（Settings）；
3. 进入 常规（General） → 高级（Advanced）；
4. 将 拖放（Drag’n’Drop） 设置为：
   • 双向（Bidirectional）（推荐）
   • 或 主机到客户机（Host to Guest）（仅需从主机拖入）
5. 启动虚拟机，测试拖放文件！