Nix 详解（六） 备忘单

### 单用户安装（不配置 channel）
# 国内镜像
sh <(curl -L https://mirrors.tuna.tsinghua.edu.cn/nix/latest/install) --no-daemon --no-channel-add
# 官方
sh <(curl -L https://nixos.org/nix/install) --no-daemon --no-channel-add
# 官方，另一种语法
curl -sSL https://nixos.org/nix/install | bash -s -- --no-daemon --no-channel-add
# 安装固定版本
curl -sSL https://releases.nixos.org/nix/nix-2.22.1/install | bash -s -- --no-daemon --no-channel-add


### 单用户卸载
sudo rm -rf /nix ~/.nix-* ~/.local/state/nix

# 添加 Channel （官方）
nix-channel --add https://nixos.org/channels/nixpkgs-unstable
# 添加 Channel （清华 mirror）
nix-channel --add https://mirrors.tuna.tsinghua.edu.cn/nix-channels/nixpkgs-unstable nixpkgs
# 下载 Channel 内容
nix-channel --update
# 删除 Channel
nix-channel --remove nixpkgs

# 列出已配置 channel 中，所有可用的包
nix-env -qaP
# 列出 /path/to/nixpkgs channel 中，所有可安装的包
nix-env -qaPf /path/to/nixpkgs
# 按关键字查询
nix-env -qaP firefox
nix-env -qaP 'firefox.*' # 支持正则
# 列出已配置 channel 中，所有可安装的包，以及其状态。
nix-env -qaPs
# -PS  nixpkgs.bash                bash-3.0
# --S  nixpkgs.binutils            binutils-2.15
# IPS  nixpkgs.bison               bison-1.875d
# I 表示已应用到当前环境，P 表示已经安装到 /nix/store 中了，S 表示在缓存 server 是否存在二进制缓存。

# 列出已安装的包的各种信息（json 格式）
nix-env -q --installed --json --out-path --drv-path --description --meta

# 安装包
nix-env -iA nixpkgs.go
# 升级包
nix-env -uA nixpkgs.go
# 升级所有包
nix-env -u
# 仅打印可以升级的包
nix-env -u --dry-run
# 卸载包（磁盘空间未释放，如需释放，参见垃圾回收）
nix-env -e go
# 安装旧版包 https://lazamar.co.uk/nix-versions/
nix-env -iA go -f https://github.com/NixOS/nixpkgs/archive/d1c3fea7ecbed758168787fe4e4a3157e52bc808.tar.gz

# nix 特色的环境版本管理（每次安装、升级、写在都会生成一个版本）
# 列出所有环境版本
nix-env --list-generations
# 回滚到上一个版本
nix-env --rollback 
# 回滚到指定版本
nix-env --switch-generation 43

# 垃圾回收
# 真正删除没有被使用的软件包
nix-collect-garbage -d

# 打开一个 shell，并安装 `go_1_19`、`jq`、`curl`。
nix-shell -p go_1_19 jq curl
# 安装包的同时，不继承环境变量，使用固定版本的 nixpkgs 的配置。
nix-shell -p go_1_19 jq curl --pure -I nixpkgs=https://github.com/NixOS/nixpkgs/archive/794f34657e066a5e8cc4bb34491fee02240c6ac4.tar.gz
# nix-shell -p go_1_19 jq curl --pure -I nixpkgs=https://mirrors.tuna.tsinghua.edu.cn/nix-channels/releases/nixpkgs-unstable%40nixpkgs-23.05pre460011.f5ffd578778/nixexprs.tar.xz


# nix-shell 实现可重现脚本
#!/usr/bin/env nix-shell
#! nix-shell -i bash --pure
#! nix-shell -p bash go_1_19 jq curl which
#! nix-shell -I nixpkgs=https://mirrors.tuna.tsinghua.edu.cn/nix-channels/releases/nixpkgs-unstable%40nixpkgs-23.05pre460011.f5ffd578778/nixexprs.tar.xz

# nix-shell 可重现脚本使用 shell.nix 的配置
#!/usr/bin/env nix-shell
#! nix-shell -i bash --pure shell.nix

# 执行一个 nix 文件，并不会递归求值。
nix-instantiate --eval nix-lang-demo/01-hello.nix
# 执行一个 nix 文件，并递归求值，并将值以 json 格式打印，注意如果包含函数这种没法序列化为 json 的将报错。
nix-instantiate --eval nix-lang-demo/02-primitives-data-type.nix --strict --json
# 执行一个 nix 文件，要求该函数返回一个 derivation 类型，或者返回值为 derivation 类型的函数。
# 然后将 derivation 序列化到 /nix/store/$hash-$name.drv 文件。
nix-instantiate nix-lang-demo/12-derivation.nix

# 将一个 /nix/store/$hash-$name.drv 转换为 json 格式，并输出。
nix --extra-experimental-features nix-command show-derivation $(nix-instantiate path/to/file.nix)

# 构建 nixpkgs 中属性为名为 go_1_19 的 derivation
nix-build '<nixpkgs>' -A go_1_19
# ls -l result
# lrwxrwxrwx  ...  result -> /nix/store/d18hyl92g30l...-go-1.19.3

# nix 表达式可以通过 -E 直接给出
nix-build -E 'with import <nixpkgs> { }; runCommand "foo" { } "echo bar > $out"'

# 可以从指定 url 的 channel 构建
nix-build https://github.com/NixOS/nixpkgs/archive/master.tar.gz -A hello

# 构建一个 /nix/store/$hash-$name.drv 文件。
nix-store -r $(nix-instantiate path/to/file.nix)
# 打印 /nix/store/$hash-$name.drv 构建过程日志。
nix-store --read-log $(nix-instantiate path/to/file.nix)

# 将一个 derivation 输出打包成 nar 包
nix-store --dump /nix/store/v02pl5dhayp8jnz8ahdvg5vi71s8xc6g-hello-2.12.1 > test.nar
# 将 test.nar 压缩为 test.nar.xz
# xz test.nar
# 将一个 derivation 的 nar 包导入当前机器
nix-store --import v02pl5dhayp8jnz8ahdvg5vi71s8xc6g.nar
# 查询一个 derivation 输出的 nar 包的 hash
nix-store -q --hash /nix/store/v02pl5dhayp8jnz8ahdvg5vi71s8xc6g-hello-2.12.1
# 查询一个 derivation 输出的 nar 包的 size
nix-store -q --size /nix/store/v02pl5dhayp8jnz8ahdvg5vi71s8xc6g-hello-2.12.1
# 查询一个 derivation 输出的直接依赖
nix-store -q --references /nix/store/v02pl5dhayp8jnz8ahdvg5vi71s8xc6g-hello-2.12.1
# 查询一个 derivation 输出的所有依赖（闭包）
nix-store -q --requisites /nix/store/v02pl5dhayp8jnz8ahdvg5vi71s8xc6g-hello-2.12.1
# 查询一个 derivation 输出对应的 drv文件
nix-store -q --deriver /nix/store/v02pl5dhayp8jnz8ahdvg5vi71s8xc6g-hello-2.12.1
# 生成签名用的 key
nix-store --generate-binary-cache-key binarycache.example.com cache-priv-key.pem cache-pub-key.pem

# 将一个 derivation 输出及其所有依赖导出到文件
nix-store --export $(nix-store -qR /nix/store/v02pl5dhayp8jnz8ahdvg5vi71s8xc6g-hello-2.12.1) > hello.closure
# 将一个 derivation 输出及其所有依赖导入到当前机器
nix-store --import < hello.closure

nix-hash --type sha256 --flat --base32 test.nar

nix-copy-closure --to [email protected] /nix/store/v02pl5dhayp8jnz8ahdvg5vi71s8xc6g-hello-2.12.1

# 禁用分页器 (END) 这种全屏显示
PAGER=

# 二进制缓存服务
substituters = https://mirrors.tuna.tsinghua.edu.cn/nix-channels/store https://cache.nixos.org/