NixOS 虚拟机实战:在 VirtualBox 客户机中安装与配置 NixOS(含 vboxsf 共享文件夹挂载)
NixOS 虚拟机实战:在 VirtualBox 客户机中安装与配置 NixOS(含 vboxsf 共享文件夹挂载)
本文是一份面向想要在 VirtualBox 中快速体验 NixOS 的用户的完整操作指南。内容以 NixOS 官方手册的 VirtualBox 客户机安装章节为主体,结合 nixpkgs 仓库中 virtualbox-guest 模块与 vboxsf 文件系统模块的源码实现,覆盖从"新建虚拟机"到"共享文件夹自动挂载"的全流程。读完本文后,你将能够在 VirtualBox 中从零装好一台 NixOS 客户机,并解决启动时 fsck 阻塞、共享目录无法自动挂载等高频问题。
为什么选择在 VirtualBox 中安装 NixOS
对于希望尝试 NixOS 而暂时不想在裸机上(bare metal)安装的用户来说,把 NixOS 装进 VirtualBox 客户机是一种非常便捷的方式。它隔离了实验环境,允许随时回滚快照,也便于反复测试 configuration.nix 中的声明式配置。
本指南对应的官方文档位于 nixos/doc/manual/installation/installing-virtualbox-guest.section.md,安装总览章节见 nixos/doc/manual/installation/installation.md。
第一步:在 VirtualBox 中新建客户机
按照以下顺序在 VirtualBox 图形界面中完成虚拟机创建:
- 新建虚拟机:在 VirtualBox 中点击"新建",OS Type 选择 Linux / Other Linux。
- 设置内存:Base Memory(基础内存)建议 768 MB 或更高。
- 创建虚拟磁盘:新建一块 10 GB 或更大的虚拟硬盘。
- 挂载安装镜像:在虚拟机的存储设置中,将 NixOS 官方 ISO 镜像挂载到 CD/DVD-ROM 光驱(通过点击 CD/DVD-ROM 图标选择镜像文件)。
- 开启 PAE/NX:进入 Settings → System → Processor,勾选 PAE/NX。
- 开启硬件虚拟化加速:进入 Settings → System → Acceleration,勾选 "VT-x/AMD-V" 加速。
- 选择显卡控制器:进入 Settings → Display → Screen,将 Graphics Controller 设置为 VMSVGA。
- 保存设置并启动:保存全部设置后启动虚拟机,即可像正常安装一样进入 NixOS 安装流程。
说明:PAE/NX 与 VT-x/AMD-V 两项是 NixOS 内核与 VirtualBox 客户机协同工作的基础,务必在首次启动前配置完成;VMSVGA 是推荐的高性能虚拟显卡,配合后文提到的 Guest Additions 可获得更好的显示体验。
第二步:启动后的安装流程与关键配置修改
启动虚拟机后按 NixOS 标准流程安装(分区、生成 /etc/nixos/configuration.nix、执行 nixos-install 等)。安装完成后,在客户的 configuration.nix 中需要做两处针对性修改。
修改 1:让 GRUB 正确引导
在 VirtualBox 中,NixOS 通常安装到 /dev/sda(IDE/SATA 虚拟磁盘),因此需要在配置中显式声明 GRUB 的安装设备:
{ boot.loader.grub.device = "/dev/sda"; }
这一行确保引导器写入虚拟磁盘的主引导记录,否则重启后可能无法找到可引导的系统。
修改 2:关闭启动时的 fsck 日志检查
NixOS 默认在启动时会对文件系统执行日志检查(journaling FS check)。在 VirtualBox 客户机中,这一步会总是失败(checkJournalingFS 检查无法在该虚拟环境下正确执行),从而阻塞启动过程,直到你手动按下 * 键才会继续。为避免每次开机都卡在这一步,请在配置中关闭它:
{ boot.initrd.checkJournalingFS = false; }
设置后,initrd 阶段的日志文件系统检查被跳过,系统可以无阻塞地直接进入启动流程。
第三步:配置共享文件夹并自动挂载(vboxsf)
共享文件夹是 VirtualBox 客户机与宿主机之间传递文件最常用的机制。其工作流程分两步:先在 VirtualBox 中定义共享目录,再在 NixOS 配置中声明挂载。
在 VirtualBox 中定义共享文件夹
进入虚拟机的 Machine → Settings → Shared Folders,点击"Add"图标,为共享目录指定:
- Name(共享名):例如
share,这个名称将被用作挂载时的device标识; - Path(宿主机路径):宿主上真实存在的目录路径。
在 configuration.nix 中声明自动挂载
编辑客户机内的 /etc/nixos/configuration.nix,加入如下声明:
{ config, pkgs, ... }:
{
fileSystems."/virtualboxshare" = {
fsType = "vboxsf";
device = "nameofthesharedfolder";
options = [
"rw"
"nofail"
];
};
}
其中:
| 配置项 | 取值示例 | 说明 |
|---|---|---|
fileSystems."/virtualboxshare" |
挂载点 | 共享文件夹将直接出现在根目录下的该路径 |
fsType |
"vboxsf" |
VirtualBox 共享文件夹专用文件系统类型 |
device |
"nameofthesharedfolder" |
必须替换为 VirtualBox 中设置的共享文件夹 Name |
options |
["rw" "nofail"] |
rw 表示读写挂载;nofail 必不可少 |
务必保留
"nofail":如果省略nofail,当共享文件夹在系统启动时尚未就绪,挂载失败会导致整个系统无法正常启动(boot 卡住)。加上nofail后,即使挂载失败系统也会继续引导,等共享可用后再挂载。
完成修改后,执行 sudo nixos-rebuild switch(或 reboot)使配置生效。挂载成功后,共享目录中的内容会直接出现在客户机的 /virtualboxshare 下。
深入原理:仓库中 vboxsf 与虚拟化模块的实现支撑
上述配置并非凭空约定,nixpkgs 仓库中提供了完整的模块化实现,理解这些源码有助于排查问题。
vboxsf 文件系统支持模块
NixOS 文件系统 vboxsf 模块 负责将 vboxsf 纳入系统支持的挂载类型。从源码结构看,它的工作逻辑如下:
- 当
config.boot.supportedFilesystems.vboxsf为真时,将mount.vboxsf辅助工具加入system.fsPackages(该工具直接取自linuxPackages.virtualboxGuestAdditions的bin目录); - 若同时
boot.initrd.supportedFilesystems.vboxsf为真,则把vboxsf内核模块提前加入 initrd 的kernelModules,使共享文件夹在 initrd 阶段(早期启动)即可挂载。
这与手册中"在 fileSystems 声明 fsType = "vboxsf""的使用方式完全对应:声明挂载项之后,模块便会在后台提供挂载所需的内核模块与用户态工具。
virtualbox-guest 客户机服务模块
VirtualBox 客户机模块 提供了 virtualisation.virtualbox.guest 一组选项(默认关闭),需要时可显式开启以获得更完整的客户机体验:
{ virtualisation.virtualbox.guest.enable = true; }
该模块的主要能力(从 nixos/modules/virtualisation/virtualbox-guest.nix 可见):
enable:是否启用 VirtualBox 服务与 Guest Additions,默认false;clipboard/seamless/dragAndDrop:分别控制剪贴板共享、无缝模式与拖放功能(默认均开启);vboxsf:是否加载 vboxsf,默认true,开启后会将vboxsf加入boot.supportedFilesystems与boot.initrd.supportedFilesystems,同时创建vboxsf用户组并分配固定 GID 73(见 nixos/modules/misc/ids.nix);use3rdPartyModules:是否使用 VirtualBox 官方提供的内核模块而非上游内核自带的模块,默认true。
启用后,模块会:
- 通过
systemd.services.virtualbox(服务单元位于multi-user.target,且ConditionVirtualization = "oracle")以前台方式运行VBoxService --foreground,提供 Guest Additions 核心服务; - 注册 udev 规则:
/dev/vboxuser设备归属vboxuserdev组(供VBoxClient使用),并为/dev/vboxguest打上systemd标签以支持 systemd 依赖; - 为剪贴板、无缝模式、拖放等能力分别生成用户级 systemd 服务,通过
VBoxClient --clipboard/--seamless/--draganddrop/--vmsvga-session等参数实现,其中无缝模式服务额外要求XDG_SESSION_TYPE=x11。
同时该模块在非 x86/aarch64 平台会触发断言失败,即当前仅支持 x86 与 aarch64 架构(断言逻辑见 nixos/modules/virtualisation/virtualbox-guest.nix)。两个模块均已在 nixos/modules/module-list.nix 中登记,属于 NixOS 默认可用的模块体系。
常见问题排查
- 启动卡在 fsck 检查:确认已设置
boot.initrd.checkJournalingFS = false;并重新nixos-rebuild switch。 - 共享文件夹没有自动挂载:确认 VirtualBox 中共享文件夹的 Name 与
device完全一致(区分大小写);确认配置中包含"nofail";如需手动验证,可在启动完成后执行mount /virtualboxshare或查看systemctl status中的挂载单元。 - 剪贴板 / 拖放不生效:检查是否已启用
virtualisation.virtualbox.guest.enable = true;,并在桌面会话(X11)下重启客户机;无缝模式要求 X11 会话。 - 安装后无法引导:核对
boot.loader.grub.device = "/dev/sda";是否与磁盘设备名一致,若使用 UEFI 安装,请按 NixOS 手册中对应的引导器配置调整。
小结
在 VirtualBox 中安装 NixOS 的完整链路是:正确创建虚拟机(内存、磁盘、PAE/NX、VT-x/AMD-V、VMSVGA)→ 挂载 ISO 并按标准流程安装 → 修改 configuration.nix(GRUB 设备与关闭 fsck 日志检查)→ 通过 fileSystems 声明 vboxsf 共享文件夹(务必带 nofail)。仓库中 vboxsf 模块 与 virtualbox-guest 模块 为上述配置提供了完整的内核模块、udev 规则与 systemd 服务支撑,理解这两份实现即可从容应对绝大多数 VirtualBox 客户机场景。