Nix 升级指南:多用户 / 单用户环境下的版本迁移与本地 Store 兼容性说明

原创2026-09-20 19:26:401,403 阅读
文章标签:包管理器构建工具开发工具编程语言配置管理操作系统

Nix 升级指南:多用户 / 单用户环境下的版本迁移与本地 Store 兼容性说明

本指南以 Nix(purely functional package manager)官方手册中的升级文档为主体,系统讲解在遵循 安装说明 完成部署之后,如何将 Nix 升级到新版本:包括升级前如何确认目标版本、Linux 与 macOS 多用户安装与单用户安装各自对应的升级命令,以及升级过程中必须警惕的本地 Store 数据库 schema 变更风险与降级回退限制。读完本文,你将掌握在常见 Linux systemd 环境、macOS launchd 环境以及单用户环境下安全执行 Nix 升级的完整实操流程,并理解 Nix 内部"版本升级 = 程序升级 + 存储迁移"的运作原理。

适用前提:本文升级步骤仅适用于按照手册中的安装说明安装 Nix 的环境(即标准的多用户 daemon 安装或单用户安装),由发行版包管理器、Docker 镜像或其他自定义方式部署的 Nix 不在此列。

一、升级前的版本确认

在动手升级之前,首先要确认新版本将安装哪个版本的 Nix。官方提供了多个发布频道(release channels),例如 nixpkgs-unstable 始终携带 Nix 最新的不稳定版本。可以通过下面的方式,临时进入一个包含最新 Nix 的 nix-shell,在其中查询版本号:

$ nix-shell -p nix -I nixpkgs=channel:nixpkgs-unstable --run "nix --version"
nix (Nix) 2.18.1

这条命令的语义拆解如下:

  • -p nix:在临时环境中安装 nix 这个包;
  • -I nixpkgs=channel:nixpkgs-unstable:指定使用 nixpkgs-unstable 频道作为依赖来源;
  • --run "nix --version":进入环境后立即执行版本查询并退出。

输出中的 nix (Nix) 2.18.1 即为目标频道当前携带的 Nix 版本号,确认该版本符合预期后再继续后续升级操作。若希望选择其他频道,可将 nixpkgs-unstable 替换为 nixpkgs(稳定频道)或 nixos-XX.XX 等其他官方频道名称。

二、升级的核心风险:本地 Store 数据库 schema 变更

这是整个升级过程中最需要理解的一点。Nix 的本地存储由一个 SQLite 数据库(位于 localstatedir/nix/db,见 nix-daemon 服务单元中的 RequiresMountsFor 挂载约束)记录所有有效 store 路径的元数据。使用更新版本的 Nix 向本地 Store 写入数据(例如通过 nix-build 构建派生式、或通过 nix-store --realise 实现 store 对象),可能会升级数据库 schema。

从源码看,Nix 在打开本地 Store 时会对数据库 schema 做版本检查与迁移,相关逻辑位于 local-store.cc:

  1. 读取当前 schema 版本(curSchema = getSchema());
  2. 若数据库尚不存在(curSchema == 0),则按当前版本的 nixSchemaVersion 初始化新库并写入 schema 版本号;
  3. 若 curSchema 小于当前支持的版本(nixSchemaVersion,定义于 local-store.hh,值为 10),则依次执行历史迁移,例如:
    • schema < 8:为 ValidPaths 表增加 ultimate 与 sigs 列;
    • schema < 9:删除 FailedPaths 表;
    • schema < 10:为 ValidPaths 表增加 ca(content-addressed)列;
  4. 迁移完成后将 schema 版本号写回磁盘。

因此,升级 Nix 之后首次运行构建类命令,很可能触发上述数据库结构升级。这意味着:一旦新版本写入并迁移了数据库,再回退到旧版本 Nix 时,旧程序可能无法识别新 schema,必须先清空(purge)store 数据库后才能继续使用。

警告:降级 Nix 版本前,请务必确认数据库 schema 是否已被升级。若已升级,回退旧版本可能要求删除本地 Store 数据库(这同时意味着此前记录的 store 路径元数据全部失效),操作前应做好数据备份与后果评估。

三、升级步骤(按安装方式分类)

以下升级命令统一使用 nix-env --install --file '<nixpkgs>' --attr nix cacert -I nixpkgs=channel:nixpkgs-unstable 完成软件包本体替换:

  • --file '<nixpkgs>':从 nixpkgs 频道表达式安装;
  • --attr nix cacert:安装 nix 与 cacert(CA 证书包)两个属性对应的包,保证新版本 Nix 拥有完整的 TLS 证书链以访问 HTTPS 二进制缓存;
  • -I nixpkgs=channel:nixpkgs-unstable:同上,指定包来源频道,可按需更换。

1. Linux 多用户安装(systemd)

多用户安装通过 root 用户操作,并在安装后重启 nix-daemon 守护进程,使新版本的服务端代码生效:

$ sudo su
# nix-env --install --file '<nixpkgs>' --attr nix cacert -I nixpkgs=channel:nixpkgs-unstable
# systemctl daemon-reload
# systemctl restart nix-daemon

步骤说明:

  • sudo su:切换到 root,因为系统级 profile 与 daemon 服务属于 root;
  • nix-env --install ...:更新 root 用户 profile 中的 Nix 本体;
  • systemctl daemon-reload:重新加载 systemd 单元定义,确保服务描述与磁盘上最新文件一致;
  • systemctl restart nix-daemon:以新二进制重启守护进程。当前仓库中的 nix-daemon.service 通过 ExecStart 启动 nix-daemon --daemon,并设置了 LimitNOFILE=1048576、TasksMax=1048576 等资源上限,重启后这些限制随新版本进程一并生效。

2. macOS 多用户安装(launchd)

macOS 多用户安装通过 sudo 直接操作(macOS 的 root 与多用户 daemon 环境约定不同于 Linux,无需 sudo su 切换):

$ sudo nix-env --install --file '<nixpkgs>' --attr nix cacert -I nixpkgs=channel:nixpkgs-unstable
$ sudo launchctl remove org.nixos.nix-daemon
$ sudo launchctl load /Library/LaunchDaemons/org.nixos.nix-daemon.plist

步骤说明:

  • 先卸载旧的 org.nixos.nix-daemon 守护进程(launchctl remove),再重新加载 plist(launchctl load),从而以新版本二进制重建守护进程。仓库中的 org.nixos.nix-daemon.plist.in 定义了该守护进程的 KeepAlive 与 RunAtLoad 行为,并通过 wait4path 等待 /nix/var/nix/profiles/default/bin/nix-daemon 就绪后再 exec 启动,日志写入 /var/log/nix-daemon.log。

3. 单用户安装(所有平台)

单用户安装没有独立 daemon 进程,升级只需更新用户自身的 profile:

$ nix-env --install --file '<nixpkgs>' --attr nix cacert -I nixpkgs=channel:nixpkgs-unstable

注意:macOS 不支持单用户安装(详见安装说明),因此该命令适用于 Linux 及其他支持单用户模式(如 FreeBSD,参考 install-freebsd-multi-user.sh 所在部署体系)的平台。单用户安装不提供多用户模式下的共享、隔离与安全特性。

四、升级完成后:验证与常见问题

验证升级结果

升级完成后,可再次查询版本确认生效:

$ nix --version

同时建议执行一次轻量级的 store 读操作(如 nix-store --query --roots 或直接构建一个小型表达式)来确认数据库 schema 迁移正常完成、daemon 与新客户端协议兼容。

常见问题排查

现象 可能原因 处理建议
升级后执行命令报数据库 schema 相关错误 新旧版本 schema 不兼容 依据第二节评估是否需要迁移或重建数据库
systemctl restart nix-daemon 失败 服务单元路径或权限异常 检查 nix-daemon.service 中 ConditionPathIsReadWrite 与挂载点是否满足
macOS 升级后 daemon 未恢复 launchd plist 加载顺序问题 检查 /var/log/nix-daemon.log,确认 wait4path 目标二进制已就位后重新 launchctl load

降级回退限制(再次强调)

Nix 的数据库 schema 是单向演进的设计:nixSchemaVersion 只会单调增加(当前为 10),旧版本无法读取新版本写入的 schema。因此,一旦在升级后的版本上执行了任何触发 schema 迁移的写操作,回退旧版本前必须清理 store 数据库,这会导致所有已记录的 store 路径失效、需要重新构建或从二进制缓存拉取。若你的环境对可用性要求较高,建议在升级前记录当前 nix --version 与数据库 schema 状态,并为关键环境规划升级窗口。

五、参考与延伸阅读

登录后查看全文
nix