NixOS 虚拟机实战:在 VirtualBox 客户机中安装与配置 NixOS(含 vboxsf 共享文件夹挂载)

原创2026-09-21 11:37:201,766 阅读
文章标签:操作系统包管理器

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 图形界面中完成虚拟机创建:

  1. 新建虚拟机:在 VirtualBox 中点击"新建",OS Type 选择 Linux / Other Linux。
  2. 设置内存:Base Memory(基础内存)建议 768 MB 或更高。
  3. 创建虚拟磁盘:新建一块 10 GB 或更大的虚拟硬盘。
  4. 挂载安装镜像:在虚拟机的存储设置中,将 NixOS 官方 ISO 镜像挂载到 CD/DVD-ROM 光驱(通过点击 CD/DVD-ROM 图标选择镜像文件)。
  5. 开启 PAE/NX:进入 Settings → System → Processor,勾选 PAE/NX。
  6. 开启硬件虚拟化加速:进入 Settings → System → Acceleration,勾选 "VT-x/AMD-V" 加速。
  7. 选择显卡控制器:进入 Settings → Display → Screen,将 Graphics Controller 设置为 VMSVGA。
  8. 保存设置并启动:保存全部设置后启动虚拟机,即可像正常安装一样进入 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 客户机场景。

登录后查看全文
nixpkgs