Skip to content

Commit 8e5669c

Browse files
ryan4yinryan4yin
committed
docs: upgrade NixOS to 25.05
1 parent 534ab77 commit 8e5669c

File tree

6 files changed

+31
-39
lines changed

6 files changed

+31
-39
lines changed

‎src/manual/Configuration.md‎

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,5 @@
11
# NixOS 配置
22

3-
::: warning 内容施工中
4-
本节内容正在修缮中，当前内容可能已经过时，仅供参考。
5-
:::
6-
73
## 包管理
84

95
这一节我们会讨论如何为你的系统添加额外的包。NixOS 包管理的方式有两种：

‎src/manual/Intro.md‎

Lines changed: 22 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -22,26 +22,24 @@ nix-channel {--add url [name] | --remove name | --list | --update [names…] | -
2222

2323
上面我们演示了命令行工具的使用方式，却没有告知频道从哪里获取。
2424

25-
频道最直接的体现是一个形如 `https://nixos.org/channels/nixos22.11` 的 URL。
25+
频道最直接的体现是一个形如 `https://nixos.org/channels/nixos-25.05` 的 URL。
2626

2727
官方提供了[官方频道集合](https://channels.nixos.org/)。订阅了其中的频道以后，就会从相应的频道获取更新，大致和你使用其他发行版的软件源类似，不过我们后面会详述 NixOS 中的“频道”概念和传统发行版中“软件源”的区别。
2828

2929
请你尝试访问上面的 URL。正如我们所说，这是一个频道集合，根目录下的每一个子目录就代表一个频道，官方提供了若干个频道：
3030

31-
```
32-
2022/8/4 22:51:25 0.1 kB nixos-21.11
33-
2022/8/4 22:59:10 0.1 kB nixos-21.11-aarch64
34-
2022/8/2 23:24:22 0.1 kB nixos-21.11-small
35-
2023/1/3 23:39:40 0.1 kB nixos-22.05
36-
2023/1/3 22:43:29 0.1 kB nixos-22.05-aarch64
37-
2023/1/2 04:11:11 0.1 kB nixos-22.05-small
38-
2023/3/16 05:19:03 0.1 kB nixos-22.11
39-
2023/3/16 22:18:18 0.1 kB nixos-22.11-small
40-
2023/3/16 14:55:20 0.1 kB nixos-unstable
41-
2023/3/16 21:27:06 0.1 kB nixos-unstable-small
42-
2023/1/2 21:05:38 0.1 kB nixpkgs-22.05-darwin
43-
2023/3/17 00:30:11 0.1 kB nixpkgs-22.11-darwin
44-
2023/3/16 04:06:35 0.1 kB nixpkgs-unstable
31+
```text
32+
2024/5/23 12:00:00 0.1 kB nixos-24.11
33+
2024/5/23 12:00:00 0.1 kB nixos-24.11-aarch64
34+
2024/5/23 12:00:00 0.1 kB nixos-24.11-small
35+
2025/5/23 12:00:00 0.1 kB nixos-25.05
36+
2025/5/23 12:00:00 0.1 kB nixos-25.05-aarch64
37+
2025/5/23 12:00:00 0.1 kB nixos-25.05-small
38+
2025/5/23 12:00:00 0.1 kB nixos-unstable
39+
2025/5/23 12:00:00 0.1 kB nixos-unstable-small
40+
2024/5/23 12:00:00 0.1 kB nixpkgs-24.11-darwin
41+
2025/5/23 12:00:00 0.1 kB nixpkgs-25.05-darwin
42+
2025/5/23 12:00:00 0.1 kB nixpkgs-unstable
4543
```
4644

4745
### 项目结构
@@ -92,7 +90,7 @@ Tarball 是 `tar` 文件格式的全称，不是 Nix 独有。它可以将多个
9290

9391
### 系统频道
9492

95-
系统频道可以从 URL 中直观的体现。形如 `https://nixos.org/channels/nixos22.11` 你很快就了解到这是一个 22.11 版本的 NixOS 的频道。
93+
系统频道可以从 URL 中直观的体现。形如 `https://nixos.org/channels/nixos-25.05` 你很快就了解到这是一个 25.05 版本的 NixOS 的频道。
9694

9795
::: tip 默认订阅的频道
9896

@@ -103,19 +101,19 @@ sudo nix-channel --list # 列出频道
103101
```
104102

105103
```bash
106-
nixos https://nixos.org/channels/nixos22.11
104+
nixos https://nixos.org/channels/nixos-25.05
107105
```
108106

109107
这个频道提供了组成系统的一些驱动，设施等等。
110108

111109
::: warning
112110

113-
这里的 `nixos` 与 `https://nixos.org/channels/nixos22.11` 并不是并列关系，前者是频道名，后面是被订阅的 URL。
111+
这里的 `nixos` 与 `https://nixos.org/channels/nixos-25.05` 并不是并列关系，前者是频道名，后面是被订阅的 URL。
114112

115113
当你有两个及两个以上频道的时候，你就会理解我的意思：
116114

117115
```bash
118-
nixos https://nixos.org/channels/nixos22.11
116+
nixos https://nixos.org/channels/nixos-25.05
119117
nixpkgs https://nixos.org/channels/nixpkgs-unstable
120118
```
121119

@@ -124,9 +122,9 @@ nixpkgs https://nixos.org/channels/nixpkgs-unstable
124122

125123
#### 一些特殊的频道
126124

127-
- 稳定（stable）频道。如 `nixos-22.11`。这些频道只能得到保守的错误修复和软件包升级。例如，频道更新可能会导致系统上的Linux内核从 4.19.34 升级到 4.19.38（一个小错误修复），但不会从 4.19.x 升级到 4.20.x（一个可能会破坏一切的重大更改）。在创建下一个稳定分支之前，通常会保持稳定的频道。
125+
- 稳定（stable）频道。如 `nixos-25.05`。这些频道只能得到保守的错误修复和软件包升级。例如，频道更新可能会导致系统上的Linux内核从 6.12.1 升级到 6.12.2（一个小错误修复），但不会从 6.12.x 升级到 6.13.x（一个可能会破坏一切的重大更改）。在创建下一个稳定分支之前，通常会保持稳定的频道。
128126
- 不稳定（unstable）频道。这与 `nixos` 的主要开发分支相对应，因此可能有破坏性更新，不建议用于生产系统。
129-
- 小型（small）频道，如 `nixos-22.11-small` 或 `nix-unstable-small`。这些频道与上述稳定和不稳定频道相同，只是它们包含较少的二进制包。这意味着它们比常规通道更新得更快（例如，当一个关键的安全补丁被提交到 NixOS 的源代码树时），但可能有更多的包需要从源代码构建。它们主要用于服务器环境，因此包含很少的 GUI 应用程序。
127+
- 小型（small）频道，如 `nixos-25.05-small` 或 `nix-unstable-small`。这些频道与上述稳定和不稳定频道相同，只是它们包含较少的二进制包。这意味着它们比常规通道更新得更快（例如，当一个关键的安全补丁被提交到 NixOS 的源代码树时），但可能有更多的包需要从源代码构建。它们主要用于服务器环境，因此包含很少的 GUI 应用程序。
130128

131129
要查看可用的频道，请转到[官方频道](https://nixos.org/channels)。（请注意，各种频道的 URI 重定向到一个包含最新版本频道的目录，还包括 ISO 映像和 VirtualBox 设备。）
132130

@@ -146,10 +144,10 @@ nix-channel --list | grep nixos
146144
nix-channel --add https://nixos.org/channels/channel-name nixos
147145
```
148146

149-
以 `nixos` 22.11 为例，命令为
147+
以 `nixos` 25.05 为例，命令为
150148

151149
```bash
152-
nix-channel --add https://nixos.org/channels/nixos-22.11 nixos
150+
nix-channel --add https://nixos.org/channels/nixos-25.05 nixos
153151
```
154152

155153
使用以下命令以开始切换
@@ -231,7 +229,7 @@ nix-channel --add https://host/nixpkgs-unstable nixpkgs
231229

232230
```bash
233231
sudo nix-channel --add https://mirrors.ustc.edu.cn/nix-channels/nixpkgs-unstable nixpkgs # 订阅镜像仓库频道
234-
sudo nix-channel --add https://mirrors.ustc.edu.cn/nix-channels/nixos-22.11 nixos # 请注意系统版本
232+
sudo nix-channel --add https://mirrors.ustc.edu.cn/nix-channels/nixos-25.05 nixos # 请注意系统版本
235233
sudo nix-channel --list # 列出频道
236234
```
237235

‎src/tutorials/installation/Networking.md‎

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -42,9 +42,9 @@ nix shell nixpkgs#cowsay --option substituters "https://mirrors.tuna.tsinghua.ed
4242
```nix
4343
{
4444
inputs = {
45-
# nixpkgs.url = "github:NixOS/nixpkgs/nixos-23.11";
46-
nixpkgs.url = "https://mirrors.ustc.edu.cn/nix-channels/nixos-23.11/nixexprs.tar.xz";
47-
# nixpkgs.url = "https://mirrors.tuna.tsinghua.edu.cn/nix-channels/nixpkgs-23.11/nixexprs.tar.xz";
45+
# nixpkgs.url = "github:NixOS/nixpkgs/nixos-25.05";
46+
nixpkgs.url = "https://mirrors.ustc.edu.cn/nix-channels/nixos-25.05/nixexprs.tar.xz";
47+
# nixpkgs.url = "https://mirrors.tuna.tsinghua.edu.cn/nix-channels/nixpkgs-25.05/nixexprs.tar.xz";
4848
};
4949
outputs = inputs@{ self, nixpkgs, ... }: {
5050
nixosConfigurations.my-nixos = nixpkgs.lib.nixosSystem {
@@ -57,7 +57,6 @@ nix shell nixpkgs#cowsay --option substituters "https://mirrors.tuna.tsinghua.ed
5757
}
5858
```
5959

60-
6160
## 3. 使用代理工具加速访问 Channels 跟 Flake Inputs
6261

6362
对于 Flake Inputs 跟 Channels 的加速访问，这个就需要使用代理工具加速访问。
@@ -92,4 +91,3 @@ sudo systemctl restart nix-daemon
9291
可尝试通过更换代理服务器或者设置
9392
[access-tokens](https://github.com/NixOS/nix/issues/6536) 来解决。
9493
:::
95-

‎src/tutorials/installation/Subsystem.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -194,7 +194,7 @@ ping 119.29.29.29 -c 4 # 腾讯 DNSPod，不通请检查网络连接
194194
```bash
195195
sudo -i
196196
nix-channel --add https://mirrors.ustc.edu.cn/nix-channels/nixpkgs-unstable nixpkgs # 订阅镜像仓库频道
197-
nix-channel --add https://mirrors.ustc.edu.cn/nix-channels/nixos-22.11 nixos # 请注意系统版本
197+
nix-channel --add https://mirrors.ustc.edu.cn/nix-channels/nixos-25.05 nixos # 请注意系统版本
198198
nix-channel --list # 列出频道
199199
nix-channel --update # 更新并解包频道
200200
nixos-rebuild --option substituters "https://mirror.sjtu.edu.cn/nix-channels/store" switch --upgrade # 临时切换二进制缓存源，并更新生成
@@ -384,7 +384,7 @@ vim /mnt/etc/nixos/configuration.nix
384384
sound.enable = true;
385385
hardware.pulseaudio.enable = true;
386386
nix.settings.substituters = [ "https://mirror.sjtu.edu.cn/nix-channels/store" ];
387-
system.stateVersion = "23.11"; # 不要改动
387+
system.stateVersion = "25.05"; # 不要改动
388388
}
389389
```
390390

‎src/tutorials/installation/VirtualMachine.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -56,13 +56,13 @@ ping 119.29.29.29 -c 4
5656
由于未知原因大陆访问远洋主机有点困难，还是用镜像服务器吧：
5757

5858
::: warning 注意系统版本
59-
截至笔者截稿，NixOS 当前最新版本为 23.05，遂命令也是针对这个版本而生效的，更新的版本请注意替换命令中的==系统版本号==。
59+
截至笔者截稿，NixOS 当前最新版本为 25.05，遂命令也是针对这个版本而生效的，更新的版本请注意替换命令中的==系统版本号==。
6060
:::
6161

6262
```bash
6363
sudo -i
6464
nix-channel --add https://mirrors.ustc.edu.cn/nix-channels/nixpkgs-unstable nixpkgs # 订阅镜像仓库频道
65-
nix-channel --add https://mirrors.ustc.edu.cn/nix-channels/nixos-23.05 nixos # 请注意系统版本
65+
nix-channel --add https://mirrors.ustc.edu.cn/nix-channels/nixos-25.05 nixos # 请注意系统版本
6666
nix-channel --list # 列出频道，这一步是确认修改没有出错
6767
nix-channel --update # 更新并解包频道
6868
nixos-rebuild --option substituters https://mirrors.ustc.edu.cn/nix-channels/store switch --upgrade # 临时切换二进制缓存源，并更新生成
@@ -174,7 +174,7 @@ vim /mnt/etc/nixos/configuration.nix
174174
nix.settings.substituters = [
175175
"https://mirrors.cernet.edu.cn/nix-channels/store"
176176
];
177-
system.stateVersion = "23.05";
177+
system.stateVersion = "25.05";
178178
}
179179
```
180180

‎src/tutorials/lang/QuickOverview.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Nix 语言的主要工作是**描述打包过程**。同时 Nix 语言也是一
1010

1111
```bash
1212
$ nix repl
13-
Welcome to Nix 2.5.1. Type :? for help.
13+
Welcome to Nix 2.23.1. Type :? for help.
1414
```
1515

1616
它有点像用于调试 JavaScript 的控制台或 Python 的交互模式？

0 commit comments

Comments
 (0)