必须安装virtualbox增强功能(guest additions)才能启用鼠标无缝移动、双向复制文字、窗口缩放和分辨率自适应等功能;arm架构麒麟os不支持该增强包,需改用qemu-guest-agent轻量替代。

要在银河麒麟系统虚拟机中启用鼠标无缝移动、主机与虚拟机双向复制文字、窗口自由缩放和分辨率自适应等功能,必须成功安装VirtualBox增强功能(Guest Additions),否则虚拟机将卡在640×480固定分辨率,拖不动窗口,也传不进文件。
图形界面一键挂载并安装(推荐桌面用户)
这一步必须在麒麟OS已成功启动并进入UKUI桌面环境后操作,不能在安装引导界面或黑屏命令行下尝试。
点击VirtualBox顶部菜单【设备】→【安装增强功能】,此时虚拟光驱自动加载VBoxGuestAdditions.iso镜像。
打开麒麟OS“文件管理器”,在左侧边栏双击“VBOXADDITIONS”光盘图标,进入挂载目录。
右键点击VBoxLinuxAdditions.run → 【以终端方式运行】。
【必须先切换到root权限再执行安装】,否则会提示“Permission denied”并中断整个流程。终端中输入:sudo ./VBoxLinuxAdditions.run,回车等待编译完成。
看到“Installing the Window System drivers”字样即表示关键图形驱动模块已写入,安装过程结束。
重启虚拟机,验证是否生效:拖动窗口边缘应能实时缩放,主机与虚拟机间可双向复制文字。
命令行手动安装(适用于无图形环境或批量部署)
当图形界面不可用或需脚本化部署时,可跳过挂载步骤,直接从ISO提取并运行安装脚本。
第一步:确认ISO已挂载并定位路径
执行 ls /media/$USER/VBOXADDITIONS/,确认能看到VBoxLinuxAdditions.run文件;若无输出,先执行 sudo mount /dev/sr0 /media/$USER/VBOXADDITIONS 手动挂载。
第二步:切换至root并执行安装sudo su → cd /media/$USER/VBOXADDITIONS → ./VBoxLinuxAdditions.run。
第三步:检查内核模块加载状态
运行 lsmod | grep vboxguest,若返回vboxguest、vboxsf、vboxvideo等模块,说明基础支持已就绪。
第四步:加载共享文件夹支持模块
执行 sudo modprobe vboxsf,否则后续创建的共享文件夹将无法挂载。
SELinux策略冲突应对(卡在policy.29错误时必做)
银河麒麟V10默认启用SELinux,而VirtualBox增强工具安装过程会尝试降级策略文件,极易触发“Could not downgrade policy file /etc/selinux/targeted/policy/policy.29”错误。
方法一:临时切换为宽容模式(推荐)
在终端执行 sudo setenforce 0,将当前会话设为Permissive模式;安装完成后立即执行 sudo setenforce 1 恢复Enforcing模式。
方法二:针对性生成豁免策略
先复现安装失败动作,再执行:sudo ausearch -m avc -ts recent | audit2allow -M vboxadd → sudo semodule -i vboxadd.pp。
【切勿直接修改/etc/selinux/config永久禁用SELinux】,该操作会削弱系统安全基线,且重启后仍需重新配置策略。
ARM平台(飞腾/鲲鹏)特殊处理
ARM架构的银河麒麟系统不支持官方VirtualBox增强功能包,也无法运行x86/x64版VBoxLinuxAdditions.run。
只能启用QEMU Guest Agent作为轻量替代方案:执行 sudo apt install qemu-guest-agent -y。
启动服务:sudo systemctl enable qemu-guest-agent && sudo systemctl start qemu-guest-agent。
该方案支持时间同步、关机指令传递和基础状态上报,但不提供图形加速、共享剪贴板或无缝鼠标功能。











