为什么在 Raspberry Pi 4 上使用 NixOS值得一试 NixOS 提供声明式系统配置和可重现的软件环境,这在嵌入式或单板计算机上尤其有价值。通过 configuration.nix 你可以将整个系统状态写成代码,便于版本控制、迁移和回滚。Raspberry Pi 4 性能与体积兼备,是学习 NixOS、搭建家用服务器或桌面实验环境的理想平台。不过在 Pi 4 上安装 NixOS 有一些特殊环节需要注意,例如镜像格式被 zstd 压缩、首次引导需要本地键盘显示、以及低内存设备在构建软件包时可能遇到问题。本指南将带你一步步完成从准备、安装到优化的全过程,并提供实用的故障排查策略和性能建议。 准备工作与硬件要求 确保你使用的是 Raspberry Pi 4,建议内存至少 2GB,更多内存会使某些构建任务更顺利。
准备一张至少 8GB 的 microSD 卡并尽量选择速度较快的卡(UHS-I 更佳)。你需要另一台电脑用于下载和写入镜像。常用工具包括 balenaEtcher(跨平台)或在 NixOS 上可用的 caligula。熟悉基础命令行操作会让流程更顺畅。 下载与解压 NixOS microSD 镜像 NixOS 对树莓派的镜像通常以 .img.zst(Zstandard)格式发布。进入官方或构建服务器页面,选择对应 aarch64/arm64 的镜像版本并下载。
镜像文件通常以 zst 压缩以节省带宽和存储空间。下载完成后如果你的写入工具无法识别 zst 文件,先用 zstd 解压:zstd --decompress nixos-sd-image-xxxx.img.zst。解压会得到 .img 文件,接下来用于刷入 microSD。 写入 microSD 卡 推荐工具是 balenaEtcher,因为它跨平台且直观,选择解压得到的 .img 文件写入 microSD。如果你在 NixOS 环境下,可以使用 caligula,它直接支持 zst 文件:caligula burn 镜像文件.img.zst。写入时注意选择正确的目标设备以免误覆写其他磁盘。
写入完成后将 microSD 卡插入 Raspberry Pi 的卡槽。 首次引导与外设需求 NixOS 镜像的首次引导通常需要连接 HDMI 显示器和键盘,因为默认映像不一定开启网络自动配置或远程访问。通电后观察启动日志,如果顺利会看到 NixOS 的 shell 提示符,例如 [nixos@nixos~]$。若无法启动,请先检查 Raspberry Pi 的 EEPROM 与引导固件是否为较新版本,必要时使用 Raspberry Pi OS 更新引导程序。 开启 SSH 的两种便捷方法 为了方便后续远程管理,建议尽快开启 SSH。有两种简单方式:为默认用户设置密码,或将你的公钥添加到 /home/nixos/.ssh/authorized_keys。
设置密码只需在本机运行 passwd,然后通过 ssh nixos@nixos.local 登录。添加密钥可以通过从 GitHub 拉取公钥,例如:curl https://github.com/你的用户名.keys > ~/.ssh/authorized_keys。注意首次同步时间可能导致证书校验误差,等待片刻重试通常可解决。 撰写并应用 configuration.nix NixOS 的核心在于 configuration.nix。官方镜像是一个非常小的基础环境,接下来通过编写 /etc/nixos/configuration.nix 来定义你的系统状态。一个典型的入门配置会包含主机名、用户、桌面环境、包和服务等。
可以直接从可靠来源下载示例配置并以 sudo tee 写入 /etc/nixos/configuration.nix,例如:curl -sL https://example.com/configuration.nix | sudo tee /etc/nixos/configuration.nix。编辑完成后使用 sudo nixos-rebuild boot 应用配置并重启。重启后你将看到配置指定的桌面或服务生效。 桌面环境与包管理的灵活性 NixOS 切换桌面环境非常方便,例如将 Gnome 切换为 KDE Plasma 只需修改几行配置并重建系统。由于配置是声明式的,切换后系统会精确应用所需包与服务。日常安装临时开发工具时,nix-shell 提供快速、无副作用的临时环境。
示例:nix-shell --packages nodejs-18_x 会在 shell 中提供 Node.js 18,而不改变系统全局状态。nix-shell 对开发者尤其友好,可在无需全局安装的情况下运行不同版本的语言工具链。 常见问题与排查方法 如果启动失败,首先检查 Pi 的引导固件,使用 Raspberry Pi OS 执行 raspi-config nonint do_boot_rom E1 来更新引导并重启,必要时使用 rpi-eeprom-update 更新 EEPROM。另一个常见问题是在 Pi 上直接构建大型 Nix 包耗尽内存。默认 2GB 的 Pi 4 在执行 nixos-rebuild 时可能因内存不足而失败。解决方法有几种:尽量依赖二进制缓存(cache.nixos.org)而非本地构建;增加交换分区或创建 swapfile 来补充内存;将构建任务交给更强的远程构建机或启用远程构建器。
使用 binary cache 可以显著减少设备上的构建负担,确保你的配置不会强制本地编译大量依赖。 性能与存储优化建议 为了提升 Pi 上 NixOS 的稳定性,优先选择速度较快的 microSD 卡或使用 USB SSD 作为根文件系统(通过镜像或后期迁移)。如果计划经常构建软件或运行数据库类应用,建议使用至少 4GB 内存的 Pi 4 型号或外接更多内存的替代方案。启用 swapfile 可以缓解短期内存压力,但频繁使用会影响 microSD 寿命,SSD 更适合高写入场景。合理设置 Nix 的存储路径和清理策略也能节省磁盘空间,例如定期运行 nix-collect-garbage。 安全性与日常维护 安装完成后请立即更改默认密码或仅使用 SSH 密钥登录。
启用防火墙并关闭不必要的服务可以减少暴露面。由于 NixOS 的声明式特性,升级和回滚都很方便:通过更新 configuration.nix 并运行 nixos-rebuild switch 或 boot,可以快速应用新配置;若出现问题可使用 nixos-rebuild switch --rollback 回退到先前版本。建议将 configuration.nix 与相关模块放入版本控制系统(如 git),以便记录更改历史和在多台设备之间复用配置。 备份策略与迁移 由于 NixOS 的配置文件描述了系统状态,备份重点应放在 /etc/nixos 和你的 home 配置上。将 configuration.nix、shell.nix、home-manager 配置等纳入仓库,可以在新设备上快速复现环境。对于完整系统镜像的备份,使用 dd 或类似工具将挂载的根分区镜像化,或采用 rsync 备份重要数据与配置文件。
实战小贴士 首次使用时尽量依赖官方的二进制镜像与缓存,避免在 Pi 上做大规模本地编译。若需要运行图形界面,确保交换与显存设置合理以避免内存耗尽。调试时保留串口或 HDMI 控制台会帮助发现启动日志和错误信息。频繁修改配置建议先在虚拟机或较强硬件上测试构建,确认不会触发本地编译然后再下发到 Pi 设备。 结语 在 Raspberry Pi 4 上运行 NixOS 会给你带来高度可重现和可管理的系统体验。尽管有一些平台特有的细节需要注意,例如 zstd 压缩的镜像、首次引导时的本地访问需求以及在低内存设备上构建软件时的限制,但一旦掌握这些要点,NixOS 能为你的 Pi 项目带来长期维护性和可迁移性的提升。
无论你想用 Pi 建家庭服务器、学习可重现构建,还是作为桌面轻量实验平台,NixOS 都是一个值得投入时间学习的强大选择。希望你顺利完成安装并在 Pi 上享受声明式配置带来的便捷体验。 。
