Nix 升级指南:多用户 / 单用户环境下的版本迁移与本地 Store 兼容性说明
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:
- 读取当前 schema 版本(
curSchema = getSchema()); - 若数据库尚不存在(
curSchema == 0),则按当前版本的nixSchemaVersion初始化新库并写入 schema 版本号; - 若
curSchema小于当前支持的版本(nixSchemaVersion,定义于 local-store.hh,值为10),则依次执行历史迁移,例如:- schema < 8:为
ValidPaths表增加ultimate与sigs列; - schema < 9:删除
FailedPaths表; - schema < 10:为
ValidPaths表增加ca(content-addressed)列;
- schema < 8:为
- 迁移完成后将 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 状态,并为关键环境规划升级窗口。
五、参考与延伸阅读
- 安装前提与多用户/单用户选型:doc/manual/source/installation/index.md
- 本地 Store 的 SQLite 数据库结构:src/libstore/schema.sql 与增量迁移逻辑 src/libstore/local-store.cc
nix-build命令说明(构建派生式的入口之一):doc/manual/source/command-ref/nix-build.mdnix-store --realise命令说明(实现 store 对象、可能触发 schema 迁移的另一入口):doc/manual/source/command-ref/nix-store/realise.md- Linux daemon 服务单元:misc/systemd/nix-daemon.service.in
- macOS daemon 属性列表模板:misc/launchd/org.nixos.nix-daemon.plist.in