NixOS安装指南

Windows安装前准备#

调整时间设置#

关于时间错乱
Linux把主板时间改成标准UTC时间，然后根据系统设置的时区对UTC时间进行加减后显示出来。Windows直接读取主板时间显示出来，所以此时你Windows显示的时间就变成了UTC时间，表面上看就像是windows时间错乱了。

PowerShell 管理员权限运行：

1
Reg add HKLM\SYSTEM\CurrentControlSet\Control\TimeZoneInformation /v RealTimeIsUniversal /t REG_DWORD /d 1

进入Live CD#

默认无密码自动登录，使用命令切换到root用户：

1
sudo -i

连接网络#

安装过程几乎肯定需要有效的网络连接。无网络的安装是可行的, 但是可用的软件包集合是受限的。

有线网络#

使用网线连接电脑，亦或是使用USB共享网络
使用命令确认网络连接：

1
ip a #查看网络连接信息
2
ping bilibili.com -c 4 # 确认网络正常
3
ping 119.29.29.29 -c 4  # 腾讯 DNSPod，不通请检查网络连接

WiFi连接#

NixOS 默认使用wpa_supplicant作为无线守护程序。
使用命令进入：

1
sudo systemctl start wpa_supplicant  # 启动服务
2
sudo wpa_cli  # 进入 wpa 命令行交互模式

接着进入交互模式：

1
> add_network
2
0
3
> set_network 0 ssid "你家 WIFI 的 SSID"
4
OK
5
> set_network 0 psk "WIFI 密码"
6
OK
7
> set_network 0 key_mgmt WPA-PSK
8
OK
9
> enable_network 0
10
OK

如果你成功连接，执行完如上的命令后你将得到类似下面的一条message：

1
<3>CTRL-EVENT-CONNECTED - Connection to 32:85:ab:ef:24:5c completed [id=0 id_str=]

这个时候你就可以通过quit命令来退出wpa_cli。
再次检测网络连接：

1
ip a #查看网络连接信息
2
ping bilibili.com -c 4 # 确认网络正常
3
ping 119.29.29.29 -c 4  # 腾讯 DNSPod，不通请检查网络连接

更换频道#

关于 Flake 与国内网络
由于 Flake 使用 Git 仓库 URL 作为 inputs，较难直接使用国内的 Channel 镜像。因此在我们尚未配置好完美的代理环境前，本指南暂时不使用 Flake，以免因为网络问题卡在半路。

警告
在订阅系统版本时请指定系统版本，一般指定当前的最新稳定版。

1
nix-channel --add https://mirrors.ustc.edu.cn/nix-channels/nixos-25.11 nixos
2
nix-channel --update  # 更新并解包频道

分区与格式化#

NixOS 安装程序附带多种分区工具。
以下示例使用cfdisk，但也提供fdisk、gdisk、parted和cgdisk。

首先，我们使用lsblk命令查看分区情况：

1
lsblk -pf  #查看当前分区情况
2
fdisk -l /dev/想要查询详细情况的硬盘  #小写字母l，查看详细分区信息
3
cfdisk /dev/nvme0n1 #选择自己要使用的硬盘进行分区

格式化分区#

再次查看分区情况

1
lsblk -pf #查看分区情况
2
fdisk -l /dev/想要查询详细情况的硬盘  #小写字母l，查看详细分区信息

格式化efi分区

1
mkfs.fat -F 32 /dev/nvme0n1p1（EFI分区名）

格式化btrfs根分区

1
mkfs.btrfs /dev/nvme0n1p2（根分区名）
2
#加上-f参数可以强制格式化

创建btrfs子卷#

什么是 Btrfs 子卷？
子卷是 Btrfs 的一个重要特性，主要用于快照管理。通常至少要创建 root 子卷（存放系统文件）和 home 子卷（存放用户文件），根据命名规范取名为 @ 和 @home。由于这两者是平级关系，所以创建 @ 的快照时不会包含 @home。这样就可以做到单独恢复系统文件，而不影响用户数据。

挂载

1
mount -t btrfs /dev/nvme0n1p2（根分区名） /mnt

创建子卷

1
btrfs subvolume create /mnt/@root
2
btrfs subvolume create /mnt/@home
3
btrfs subvolume create /mnt/@nix

可选：确认

1
btrfs subvolume list -p /mnt

取消挂载，因为我们要重新挂载子卷：

1
umount /mnt

正式挂载#

挂载root子卷

1
mount -o subvol=@root,compress-force=zstd /dev/nvme0n1p2 /mnt

压缩算法选择
使用 compress-force 而不是 compress，是因为前者会让 Zstd 算法自己判断是否可压缩，这比内核自带的快速启发式检查（compress）压缩率更高。如果您的磁盘空间非常有限，可以指定一个更高的压缩等级，例如 compress-force=zstd:7。Zstd 可选的等级范围是 -15 (快) 到 15 (慢，高压缩率)，默认是 3。

挂载home子卷

1
mount --mkdir -o subvol=@home,compress-force=zstd /dev/nvme0n1p2 /mnt/home

挂载nix子卷

1
mount --mkdir -o subvol=@nix,noatime,compress-force=zstd /dev/nvme0n1p2 /mnt/nix

挂载efi分区（ESP）

1
mount --mkdir /dev/nvme0n1p1 /mnt/efi

复查挂载情况

1
df -h

编辑系统配置#

使用以下命令生成基础配置：

1
nixos-generate-config --root /mnt

用户密码准备
马上我们要编辑系统的核心配置，如果你不想配置好系统启动后无法登录，我们需要提前生成密码哈希值：

1
mkpasswd -m sha-512

注意： 运行后输入你的密码，它会输出一串极其复杂的哈希字符串（例如 $6$F...），请把这串字符复制或拍照记录下来，下一步编辑配置时会用到！

然后编辑配置：

1
nano /mnt/etc/nixos/configuration.nix

1
{ config, lib, pkgs, ...}:
2
{
3
    imports = [ ./hardware-configuration.nix ];
4
    boot.loader = {
5
        grub = {
6
            enable = true; #启用GRUB
7
            default = "saved";
8
            device = "nodev"; # `nodev`表示将生成一个 GRUB 引导菜单，但不会实际安装 GRUB。
9
            efiSupport = true; #启用EFI支持
10
            useOSProber = true; # 使用OSprober搜索其他系统
11
            extraConfig = ''
12
                GRUB_SAVEDEFAULT=true
13
            '';
14
        };
15
        efi = {
16
            canTouchEfiVariables = true;
17
            efiSysMountPoint = "/efi";
18
        };
19
    };
20
    networking = {
21
        hostName = "NixOS";
22
        networkmanager.enable = true;
23
    };
24

25
    time.timeZone = "Asia/Shanghai";
26
    i18n.defaultLocale = "en_US.UTF-8";
27

28
    # ==== Display Manager ====
29
    services.greetd.enable = true;
30
    services.greetd.settings = {
31
        default_session = {
32
            command = "${pkgs.greetd.tuigreet}/bin/tuigreet --cmd niri";
33
            user = "greeter";
34
        };
35
    };
36

37
    # ==== Window Manager ====
38
    programs.niri.enable = true;
39

40
    # ==== Audio ====
41
    services.pipewire = {
42
        enable = true;
43
        alsa.enable = true;
44
        alsa.support32Bit = true;  # 需要 32 位音频支持可保留
45
        pulse.enable = true;       # 兼容 PulseAudio
46
        jack.enable = true;        # 需要 JACK 可保留，不需要可删
47
    };
48

49
    # ==== User ====
50
    users.mutableUsers = false; # 让用户完全由配置控制
51
    users.users.sui = {
52
        isNormalUser = true;
53
        hashedPassword = "$6$F1JgV....$kK1R3z....";
54
        extraGroups = [ "wheel" "networkmanager" ];
55
    };
56

57
    environment.systemPackages = with pkgs; [
58
        neovim
59
    ];
60

61
    nix.settings.substituters = [ "https://mirrors.ustc.edu.cn/nix-channels/store" ];
62
    system.stateVersion = "25.11";  # 不要改动
63
}

对于hardware-configuration.nix不需要太多改动。

先获取分区uuid

1
blkid

填入各子卷的挂载参数以及uuid修改/boot为/efi

1
# 省略其余配置
2
fileSystem = {
3
            "/" = {
4
                device = "...";
5
                fsType = "btrfs";
6
                options = [ "subvol=@root" "compress-force=zstd" ];
7
            };
8
            "/home" = {
9
                device = "...";
10
                fsType = "btrfs";
11
                options = [ "subvol=@home" "compress-force=zstd" ];
12
            };
13
            "/nix" = {
14
                device = "...";
15
                fsType = "btrfs";
16
                options = [ "subvol=@nix" "noatime" "compress-force=zstd" ];
17
            };
18
            "/efi" = {
19
                device = "...";
20
                fsType = "vfat";
21
            };
22
# 省略其余配置
23
}

部署系统#

1
sudo nixos-install --option substituters https://mirrors.ustc.edu.cn/nix-channels/store

最后只要重启电脑，祈求它能正常进入系统